JVM之jcmd命令详解

jcmd 是 Oracle JDK（Java Development Kit）自 JDK 7 起引入的一个强大的诊断工具，用于与正在运行的 JVM（Java Virtual Machine）实例进行交互。它允许用户执行各种诊断命令，比如线程堆栈分析、堆转储、GC 信息、类加载器统计等，非常适合在生产环境中对 Java 应用程序进行调试和监控。

一、jcmd 命令基本语法

jcmd <pid | main-class> <command> [options]

• ：目标 Java 进程的进程 ID。
• ：目标 Java 应用的主类名（可以省略 jar 路径）。
• ：具体的诊断命令，比如 VM.flags。
• [options]：命令附带的参数（具体取决于命令）。

---

二、查看可用的 Java 进程

jcmd

输出

970 com.dzy.Main
67890 org.apache.catalina.startup.Bootstrap

表示当前有两个 Java 进程在运行，它们的进程 ID 分别是 970 和 67890。

---

三、常用命令详解与使用示例

1. 查看所有支持的命令

jcmd <pid> help

用法

jcmd 970 help

输出

列出该 JVM 实例支持的所有命令：

970:
VM.version
VM.command_line
VM.flags
Thread.print
GC.heap_info
GC.run
GC.class_histogram
...

2. 查看 JVM 版本信息

jcmd <pid> VM.version

用法

jcmd 970 VM.version

输出

970:
Java HotSpot(TM) 64-Bit Server VM version 17.0.9+11-LTS-201
JDK 17.0.9

3. 查看启动参数

jcmd <pid> VM.command_line

用法

jcmd 970 VM.command_line

输出

Command line:  -Xmx2G -Xms1G -Dspring.profiles.active=prod -jar app.jar

---

4. 查看 JVM 参数（flags）

jcmd <pid> VM.flags

用法

jcmd 970 VM.flags

输出

-XX:InitialHeapSize=1073741824 -XX:MaxHeapSize=2147483648 -XX:+UseG1GC

---

5. 打印线程堆栈（类似 jstack）

jcmd <pid> Thread.print

用法

jcmd 970 Thread.print

输出

列出所有线程的栈信息，包括锁等待、阻塞等，非常适合死锁分析。

6. 强制触发 GC

jcmd <pid> GC.run

用法

jcmd 970 GC.run

此命令不会显示太多输出，但会触发一次完全 GC。

7. 获取堆信息（heap 使用情况）

jcmd <pid> GC.heap_info

用法

jcmd 970 GC.heap_info

输出

Heap Configuration:
   MinHeapFreeRatio         = 40
   MaxHeapFreeRatio         = 70
   ...
Heap Usage:
   G1 Heap:
      regions  = 2048
      capacity = 2048M
      used     = 1024M
      free     = 1024M

---

8. 导出 heap dump（堆快照）

jcmd <pid> GC.heap_dump /path/to/heapdump.hprof

用法

jcmd 970 GC.heap_dump /tmp/app-heap.hprof

文件可以用 MAT 或 VisualVM 分析。

9. 类直方图（类实例计数）

jcmd <pid> GC.class_histogram

用法

jcmd 970 GC.class_histogram
或者输出到文件
jcmd 970 GC.class_histogram > histogram.txt

输出

 num     #instances         #bytes  class name
----------------------------------------------
   1:        10000        1600000  [C
   2:         5000         800000  java.lang.String
   3:         3000         720000  java.util.HashMap

10. 导出类加载器信息

jcmd <pid> VM.class_loader_stats

用法

jcmd 970 VM.class_loader_stats

输出

统计各类加载器加载的类数量、占用内存等信息。

11. 检查是否发生了死锁

jcmd <pid> Thread.print

用法

jcmd 970 Thread.print

系统会显示哪些线程在等待锁、拥有锁，如果存在死锁，会提示 Found one Java-level deadlock.

12. 查看 Metaspace 使用情况

jcmd <pid> VM.native_memory summary

用法

jcmd 970 VM.native_memory summary

需要启动 JVM 时开启：

-XX:NativeMemoryTracking=summary

13. 查看系统属性（类似 System.getProperties）

jcmd <pid> VM.system_properties

用法

jcmd 970 VM.system_properties

14. 使用 Java Flight Recorder（JDK 11+）

JFR.start, JFR.dump, JFR.stop

# 启动 JFR
jcmd 970 JFR.start name=profile settings=profile duration=60s filename=/tmp/recording.jfr

# 手动 dump
jcmd 970 JFR.dump name=profile filename=/tmp/manual.jfr

# 停止 JFR
jcmd 970 JFR.stop name=profile

15. 查看 JIT 编译缓存区状态

jcmd <pid> Compiler.codecache

用法

jcmd 970 Compiler.codecache

四、常见场景使用

性能监控中查看当前内存使用情况

jcmd $(pidof java) GC.heap_info

导出内存快照进行 OOM 分析

jcmd $(pidof java) GC.heap_dump /tmp/dump-$(date +%s).hprof

分析线程死锁或阻塞线程

jcmd $(pidof java) Thread.print > /tmp/thread-dump.log

定时触发 GC 以排查内存回收异常

watch -n 60 "jcmd $(pidof java) GC.run"

Java 服务卡顿，想排查是否 GC 频繁

jcmd <pid> GC.heap_info
jcmd <pid> GC.class_histogram
jcmd <pid> GC.run
jcmd <pid> GC.class_histogram

比较前后对象数量是否减少，分析垃圾回收效率。

服务 CPU 飙高，定位是哪条线程

1. 查看线程信息（找到耗 CPU 的线程）

top -Hp <pid>

2. 将该线程 TID 转为十六进制（假设是 970 → 0x3039）

print "%x/n" <pid>

3. 在 jcmd 输出中查找栈

jcmd <pid> Thread.print | grep -A 20 0x3039

导出类实例占用查看内存增长

jcmd <pid> GC.class_histogram > before.txt
# 10分钟后
jcmd <pid> GC.class_histogram > after.txt
diff before.txt after.txt

分析 JVM 启动参数差异

jcmd <pid> VM.flags
jcmd <pid> VM.command_line

五、注意

• jcmd 只能对当前用户启动的 Java 进程使用，或者以 root 权限运行。
• 输出信息比较多，建议重定向到文件进行分析。
• 和 jstack、jmap 等相比，jcmd 更统一、更高效。

功能	命令
查看进程列表	jcmd
查看支持命令	jcmd help
JVM 版本	jcmd VM.version
JVM 启动参数	jcmd VM.command_line / VM.flags
手动 GC	jcmd GC.run
打印线程堆栈	jcmd Thread.print
类占用分析	jcmd GC.class_histogram
原生内存	jcmd VM.native_memory summary
启动/导出 JFR	jcmd JFR.*