JDK内置的Serviceability Agent（简称SA）是一套用于调试和分析JVM的底层工具集，它可以直接访问正在运行的JVM进程的物理内存镜像，获取常规监控工具无法拿到的底层运行时数据，比如对象在内存中的实际布局、类元数据的存储状态、线程栈的完整上下文等。
SA工具的核心能力与适用场景
SA工具的核心优势在于它不需要JVM配合暴露数据，而是直接读取进程的内存空间，因此即使JVM处于卡死、假死状态，只要进程还存在，就可以使用SA工具进行分析。常见的适用场景包括：
- 排查JVM内存泄漏时，需要查看所有存活对象的类型和引用关系
- 分析类加载异常，需要确认类元数据的实际存储情况
- 定位线程死锁或异常挂起问题，需要获取线程栈的完整内存上下文
- 验证JVM参数生效情况，比如内存区域的实际划分是否符合预期
环境准备与工具启动
环境要求
首先需要确保本地安装的JDK版本包含SA工具，通常Oracle JDK和OpenJDK的默认发行版都内置了该工具，工具类位于sa-jdi.jar包中，该文件一般在JDK安装目录的lib文件夹下。
另外需要保证执行分析操作的用户有权限访问目标JVM进程，Linux系统下需要和目标进程的用户一致，或者拥有root权限，Windows系统下需要管理员权限。
启动SA的图形化分析工具HSDB
HSDB（HotSpot Debugger）是SA工具提供的图形化界面，适合新手快速上手，启动步骤如下：
第一步，打开命令行终端，切换到JDK的lib目录，执行以下命令启动HSDB：
# 替换为实际的JDK lib目录路径 cd /usr/local/jdk1.8.0_301/lib # 启动HSDB，指定目标JVM的进程ID java -cp sa-jdi.jar sun.jvm.hotspot.HSDB
第二步，在弹出的HSDB界面中，点击File -> Attach to HotSpot process，输入目标JVM的进程ID，点击确定即可连接到目标进程。
深入剖析物理内存镜像的实操步骤
查看JVM内存区域整体分布
连接进程后，点击Tools -> Memory Viewer，可以查看整个JVM进程的物理内存映射情况，包括堆内存、元空间、线程栈、代码缓存等区域的实际地址范围和大小。如果需要查看某个具体内存地址的内容，可以在地址栏输入地址，点击Go查看对应的内存数据。
分析堆内对象分布
点击Tools -> Heap Analyzer，可以打开堆分析界面，这里会展示堆中所有存活对象的统计信息，包括每个类的实例数量、总占用内存大小。如果需要查看某个具体对象的详细信息，可以双击对应的类条目，会展示该类的所有实例列表，点击单个实例可以查看对象的字段值、引用的其他对象等信息。
以下是一个通过SA的命令行工具jmap的SA模式导出堆对象的示例，该命令会输出堆中所有对象的统计信息：
# 使用SA模式导出堆对象统计，pid替换为目标进程ID java -cp sa-jdi.jar sun.jvm.hotspot.tools.jmap -histo pid
查看线程栈与上下文信息
点击Tools -> Thread Viewer，可以查看目标JVM所有线程的列表，点击某个线程可以查看该线程的完整栈信息，包括栈中每个栈帧对应的方法、局部变量、关联的监控器等信息。如果线程处于阻塞状态，还可以直接看到阻塞的原因和等待的锁对象信息。
分析类元数据信息
点击Tools -> Class Browser，可以查看所有已加载的类的信息，包括类的完整类名、父类、实现的接口、加载该类的类加载器、类的方法列表等。如果需要查看某个类的元数据在内存中的存储结构，可以双击该类，查看对应的Klass结构体的详细信息。
注意事项与常见问题
使用SA工具分析正在运行的JVM进程时，会导致目标进程暂停，因为SA需要冻结进程的内存状态来保证数据的一致性，因此生产环境使用时要尽量选择业务低峰期，避免影响正常业务。
如果连接进程时提示权限不足，需要检查执行命令的用户是否和目标JVM进程的用户一致，Linux系统下可以使用ps -ef | grep java查看目标进程的用户，切换用户后重新执行连接操作。
如果SA工具版本和JVM版本不匹配，可能会出现连接失败或者数据解析错误的情况，因此需要保证执行SA工具的JDK版本和目标JVM的版本一致。
SA工具属于底层调试工具，部分操作可能会影响JVM运行稳定性，非必要情况不要在生产环境频繁使用，分析完成后及时断开连接。
Serviceability_AgentJVM物理内存镜像SA工具JDK修改时间：2026-07-18 05:54:30