外观
JVM 速记手册
摘要
以 HotSpot 和 Java 17 常用诊断工具为基线。JVM 管理对象和线程,操作系统提供资源;先把业务症状、运行时事件和容器计账对齐,再选择诊断动作。JDK 21 及以上的新特性、收集器和参数必须按实际发行商与构建核对。
快速入口
知识速记
| 知识点 | 核心结论与条件 |
|---|---|
| 堆与引用 | 局部变量中的引用和它指向的对象是两层;源码作用域结束不等于对象立即回收 |
| 进程内存 | 堆、元空间、线程栈、代码缓存、直接内存及本地库共同占预算;Xmx 不是进程总内存上限 |
| 对象创建 | 分配、默认值与构造器是不同步骤;JIT 可能消除分配,源码 new 次数不等于实际分配次数 |
| GC 可达性 | 被根路径引用的对象可能仍存活,即使业务已不需要;GC 不替应用实现缓存淘汰 |
| 资源关闭 | 对象回收不代替文件、连接和任务的及时关闭;资源生命周期需要明确所有者 |
| GC 指标 | 分配率、回收后存活量、停顿、并发工作和 CPU 要一起看;少 GC 不一定更快 |
| G1 与 ZGC | 并发阶段与暂停阶段分工不同,都有 CPU、内存及吞吐成本;收集器默认与能力依版本 |
| 类生命周期 | 加载、链接、初始化不是同一步;首次主动使用可能触发初始化和相关等待 |
| 类型身份 | 同名类被不同定义加载器加载可成为不同类型;查 ClassCastException 时看加载器 |
| 类卸载 | 类加载器及其相关对象仍被引用会影响卸载;热部署泄漏不能只看业务对象数量 |
| JIT 与预热 | 热点编译、内联及优化有成本;启动期和稳定期不同,假设失效可触发去优化 |
| JMM | 可见性和排序规则不能用某 CPU 上一次成功测试代替;volatile 不让复合操作原子化 |
| 字节码兼容 | 调用方 class 保存期望的方法描述符;源码里有同名方法不保证二进制兼容 |
| JDK 迁移 | 能启动只覆盖一部分:依赖、反射、代理、编码、TLS、工具、性能和回滚都要验收 |
内存区域与常见 OOM:错误名称直接对应检查方向
| 区域或对象 | 保存什么 | 常见检查方向 |
|---|---|---|
| Java 堆 | 对象和数组的主要存储 | 分配速率、回收后存活量、到根引用链 |
| 线程栈 | 栈帧、局部变量、调用状态 | 递归深度、线程数和 Xss 预算 |
| 元空间 | HotSpot 的类元数据 | 类与加载器数量、动态生成类、热部署残留 |
| 代码缓存 | 已编译代码等 | 编译活动、代码缓存使用及目标配置 |
| 直接及本地内存 | 直接缓冲、JNI、运行库等 | 分配及释放路径、进程/容器计账 |
Java heap space 先查堆预算与对象保留;Metaspace 先查加载器和类增长;unable to create native thread 查线程数、系统限制与进程总内存;StackOverflowError 查调用深度和递归退出条件。OOMKilled 是内核/平台终止现象,可能没有 Java 异常或堆转储。Xmx 只限制最大 Java 堆,不是容器应配置的全部内存。
GC:可达性、停顿、分配与泄漏
GC 从根集合沿引用找存活对象。对象业务上无用但仍被长生命周期集合引用,会继续存活。分配很多只说明产生对象快;泄漏关注不该继续保留的对象。看回收后基线持续上涨,再结合到根路径判断,不能只看峰值。
标记找活对象,清除释放位置,复制或整理搬迁对象以回收连续空间。Stop-The-World 是应用线程被暂停执行相关协调工作,并发 GC 表示部分工作与应用同时执行,不表示完全没有暂停或没有 CPU 成本。
G1 以 Region 管理堆,通过选区回收控制部分暂停工作;ZGC 把更多工作移到并发阶段,仍需要资源余量。具体代际、屏障和默认配置依 JDK 版本,不能记成“某个收集器永远最好”。看业务尾延迟、吞吐、GC 暂停、并发 CPU 和分配共同变化。
类加载、初始化与二进制错误
加载得到类定义;链接包括验证、准备和解析等职责;初始化执行静态初始化逻辑。静态初始化可以触发依赖初始化与等待,不宜把不受限远程调用放进去。
- ClassNotFoundException:在特定加载请求中没找到目标类,查加载路径与依赖。
- NoClassDefFoundError:类定义或初始化等问题导致后续无法正常使用,保留最早原因;不能只看最后报错。
- NoSuchMethodError:运行时目标类没有调用方期望的名称与描述符,查发布产物、依赖版本和加载来源。
- ClassCastException:先查类型,再查定义加载器;同名类由不同加载器定义可能不是同一类型。
JIT、JMM 与参数选择
解释执行便于启动,热点编译产生更优化的机器码。预热包括加载、初始化、编译与缓存建立;优化依赖假设,假设变化可去优化。微基准需预热、重复进程和结果消费,不能把首次调用耗时当作稳态性能。
JMM 定义多线程读写可观察的行为;volatile 保证相关可见性与顺序,但 count++ 是读、加、写,不原子。锁的释放与同锁后续获取、线程启动与 join 等有相应 happens-before 关系。一次 x86 测试通过不证明普通字段发布安全。
Xms/Xmx 分别控制初始与最大堆,Xss 影响线程栈预算;增加堆减少部分回收压力也可能增加存活集合及挤压非堆。停顿目标是目标,不是每次暂停的硬保证。先查 VM.flags 的实际生效值,再做同负载比较,不把部署文件中的配置直接当作运行结果。
CPU 高与对象上涨:直接使用的诊断分支
CPU 高先确认进程与配额,再按业务计算、GC、编译、本地调用和重试分类。多个时间窗同一线程持续处于相同计算热点,支持进一步代码定位;RUNNABLE 本身不证明消耗 CPU。线程都在等锁而 CPU 高时,还可能是另一个持锁线程、自旋或 GC。
对象上涨先看正常负载/缓存预热,再看回收后基线;若持续增长且类型集中,用有预算的堆转储分析支配关系与到根路径。histogram 列类型数量,不能单独回答谁持有对象。线程栈是位置快照,JFR 是按配置采集的时间事件,heap dump 是引用快照,三者不要互换。
诊断命令拿到输出后看哪些字段
Thread.print 看线程名、状态、栈顶、等待锁与持有锁;重复快照仍不变时找持有者与外部依赖。jstat 看相邻采样 GC 次数和时间增量,不只看自启动总数。GC 日志看暂停时间、原因、回收前后占用和同窗分配。JFR 先确认事件启用、阈值和录制覆盖窗口;没有事件可能是未采到,不是没有发生。
JDK 迁移验收至少覆盖依赖加载、反射与代理、TLS/编码、诊断工具、启动和稳态性能。回滚同时考虑已经写入的数据与外部协议,能换回 JDK 不等于所有外部影响都能撤销。
常见问题排查
| 现象 | 检查顺序 | 关键证据与下一步 |
|---|---|---|
| CPU 持续高 | 对齐流量与 quota → 区分业务、GC、编译 CPU → 采多次线程或短录制 | RUNNABLE 不是 CPU 归因;同线程重复栈与采样热点支持进一步定位。 |
| 回收后堆仍上涨 | 对照负载 → 看回收后基线 → 查对象保留关系 | 分配多与保留多不同;有预算后采堆,用到根路径验证生命周期,而非只看大类。 |
| Java OOM | 保存最早完整异常 → 分类 heap、metaspace、direct、native thread → 查对应预算 | 不同错误不能都靠增 Xmx;看资源释放、类加载器与线程数量。 |
| 容器 OOMKilled | 对齐重启时间与平台事件 → 查 cgroup 内存 → 汇总非堆预算 | 137 不是单独证据,JVM 也未必来得及 dump;先查内核事件和实际限制。 |
| 请求卡住但无死锁 | 看入口排队 → 查线程栈锁与初始化 → 查下游和资源持有者 | 一份栈只说明瞬时位置;多窗口对照,寻找阻塞者与外部依赖。 |
| 发布后方法找不到 | 保留完整 LinkageError → 对照运行 class、依赖树和加载来源 | 查描述符及版本组合;不要只重新编译一部分调用方。 |
| 新 JDK 性能退化 | 保持同负载及资源 → 对照 GC、编译、线程和本地库 → 分启动及稳态 | 一次吞吐变化不证明收集器责任;一次只改一个因素并保留回滚条件。 |
高频问题:操作与结果判断
以下工具以 Linux、HotSpot JDK 17 为基线,PID 和路径必须替换,工具与目标用户、容器 PID 视图匹配。
CPU 高:从操作系统线程定位 Java 栈
bash
top -H -p PID
printf '%x\n' TID
jcmd PID Thread.print -lTID 替换为 top 中持续消耗 CPU 的线程号;printf 把十进制转十六进制。例如 12345 对应 3039,在栈中找 nid=0x3039。Linux 线程号与 HotSpot nid 的对应需要相同 PID namespace;容器外看到的号不能直接套到容器内。
间隔数秒采两三份栈,关联同一时间窗。若同一业务栈持续计算,定位循环、序列化、大集合和重试;若是 GC 线程热点,转查分配和 GC 日志;若采样时栈变化很快,使用短录制而不是强行归因一份栈。
bash
jcmd PID JFR.start name=cpu settings=profile duration=30s filename=/tmp/cpu.jfr输出目录必须有权限和空间;profile 增加观测成本。用 JDK Mission Control 查看 CPU 样本、分配和锁事件,采样热点不是每次请求的完整调用链。结束后用同等流量核对 CPU、吞吐和尾延迟,不只看热点方法消失。命令选项见 JDK 17 jcmd。
GC 频繁:读懂回收前后,而不是只数次数
启动时可配置轮转日志,以下为配置片段:
text
-Xlog:gc*:file=/var/log/app/gc.log:time,uptime,level,tags:filecount=5,filesize=20M目录需可写。假设看到 Pause Young ... 512M->128M(1024M) 12.0ms:表示该次记录的堆占用从 512MiB 降到 128MiB、堆容量约 1024MiB、暂停约 12ms,不能解释为“业务请求耗时 12ms”。
- 回收后基线稳定、Young GC 很密:检查分配率、批处理大小与短命对象,先判断 GC 是否已影响业务预算。
- 回收后基线随负载或缓存预热上升后稳定:核对容量与淘汰,不立即定义为泄漏。
- 可比负载下,多个有效回收周期后的基线仍涨:查保留对象及根路径。一次 Young GC 没清空老年代不足以证明泄漏。
- 暂停下降但 CPU 上涨:把并发 GC 工作纳入总成本,再决定配置是否有收益。
OOM:堆转储什么时候有用
先保存异常的完整名称及最早原因。Java heap space 且进程仍在时,用 GC 日志判断容量不足还是保留增长;事先启用 HeapDumpOnOutOfMemoryError 和可写 HeapDumpPath 可保留故障证据。堆转储可能暂停应用、占用大量磁盘并包含敏感数据,不作为所有 OOM 的第一步。
分析时看 dominator tree 的 retained size,再追 GC Roots:例如长生命周期 Map → value → 大数组,是需要检查的保留路径;仅看到 byte[] 最大,不能直接判定 byte[] 是泄漏源。核对缓存上限、失效清理、请求上下文和类加载器生命周期。
Metaspace 查类加载器增长;unable to create native thread 查线程数、系统限制与非堆余量;OOMKilled 优先查容器/内核终止记录,堆转储未生成不意味着没有内存问题。
容器内存预算:Xmx 留多少不是固定百分比
示例预算:容器 2GiB,最大堆 1GiB,元空间和代码缓存估 200MiB,直接内存估 256MiB,200 个平台线程按 Xss=1MiB 预留约 200MiB,剩约 368MiB 给本地库、其他计账与波动。这只是规划示例,不是实测 RSS;线程栈预留与实际驻留不同,各项峰值可能重叠。
若这些需求已经逼近 limit,应减少并发/缓存、调整资源或拆分工作,不能单纯增加堆。可在启动时开启 NativeMemoryTracking=summary,再用 jcmd PID VM.native_memory summary 看 HotSpot 分类;NMT 不覆盖所有第三方本地分配,也不能替代 cgroup 计账。
发布后 NoSuchMethodError:检查实际加载的产物
先记录错误中的类名、方法名和描述符,再检查运行包内的依赖版本及重复类。用 javap -p -s 查看目标 class 的方法描述符,与调用方需要的参数/返回类型逐项比较。源码同名不代表二进制签名一致。
构建依赖树与运行包不同:查打包、部署残留、容器镜像和额外 classpath。多个加载器加载同名类:查类加载来源和容器隔离。修复应让调用方与依赖组合一致,回归启动、关键调用及回滚路径,不能只确认重新编译成功。
工具与参数
命令中的 PID 是已确认的 Java 进程编号占位符,必须替换。工具与目标 JDK、用户权限、容器视图要匹配;输出可能含业务数据。下列诊断影响见 Oracle Java 17 jcmd 手册。
| 操作 | 重点输出 | 环境与边界 |
|---|---|---|
java -version | 当前命令行 JDK 版本 | 不保证等于目标服务版本,需再查实际进程 |
jcmd PID help | 目标支持的命令 | 先看目标能力,再用 help 命令名 查参数和影响 |
jcmd PID VM.version | 目标运行时版本 | 核对 vendor、build,不用本机 java 代替 |
jcmd PID VM.flags | 已生效标志 | 对照部署配置;默认、环境注入和命令行可能不同 |
jcmd PID Thread.print -l | 线程、栈、锁 | 中等影响,依线程量;有限次数采样,不视为持续 CPU 分析 |
jstat -gcutil PID 1000 5 | 五次 GC 相关比例与计数 | 1 秒间隔;字段与收集器有关,累计值需按窗口求差 |
jcmd PID JFR.check | 已有录制状态 | 新录制需限定时长、配置及输出位置;已有录制并不包含所有事件 |
javap -c -p 文件.class | 指令、方法与私有成员 | 离线看实际发布产物;不证明 JIT 最终机器码 |
-Xms、-Xmx、-Xss | 初始/最大堆、线程栈预算 | 参数选择依负载;增堆可能挤压非堆,减栈要验证深调用 |
-Xlog:gc* | Java 9+ 统一 GC 日志 | 文件输出要配轮转与磁盘预算;记录时间才能关联业务窗口 |
高影响 histogram、heap dump 和动态增强不作为默认第一步。只有对象保留或方法行为的假设需要这些证据时,才选择单实例、有限采集窗口、明确输出目录与保留期限;磁盘、延迟或 CPU 达到预定边界就停止采集。
易错点与记忆提示
- 看回收后基线,不只看峰值:负载变化和缓存预热也会改变基线。
- 堆有余不等于进程有余:容器计账包括非堆和其他资源。
- 栈看位置,JFR 看时间,堆看保留:三者互补,不能混作同一种证据。
- 参数先查生效,再谈收益:停顿目标不是硬性延迟保证。
- GC 管内存,应用管生命周期:缓存、连接和任务仍需及时释放。
- 调优以业务验收:同时检查吞吐、尾延迟、错误、CPU 和内存,而非只降 GC 次数。
原理与完整示例
需要原因、源码或完整实验时再阅读: