Java GC故障排查速查手册:看到Full GC频繁→怀疑元空间不足或类泄漏→查gc.log中“Metadata GC Threshold”→调大-XX:MaxMetaspaceSize并检查CGLIB代理;看到young GC每秒多次→怀疑短生命周期对象过多→查jstat -gc PID观察YGC频率→优化字符串拼接或调大-Xmn;看到real time>1s→立即取堆转储分析存活对象。

编写一份实用的 Java 垃圾回收(GC)故障排查速查手册,核心是聚焦高频问题、关键指标、典型现象与对应操作,避免理论堆砌,强调“看到什么 → 怀疑什么 → 查什么 → 怎么调”。以下是可直接落地的结构和内容建议:
一、先看现象,快速归类问题类型
GC 问题通常表现为三类可感知症状,按优先级检查:
- 应用卡顿或响应超时:特别是偶发性长停顿(>1s),优先怀疑 Full GC 频繁或单次耗时过长;
- 内存持续增长,最终 OOM:关注 java.lang.OutOfMemoryError: Java heap space 或 metaspace,区分是堆内存泄漏还是元空间膨胀;
- CPU 持续偏高(非业务逻辑导致):可能是 GC 线程频繁工作(如 CMS concurrent mode failure 后的抢救式回收,或 G1 的混合回收压力过大)。
二、必须开启的基础监控参数
没有日志,一切排查都是猜测。JVM 启动时至少加以下参数(以 JDK 8/11 通用写法为例):
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
- -Xloggc:/path/to/gc.log -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=20M(JDK 9+ 推荐用 -Xlog:gc*:file=/path/to/gc.log:time,tags,level);
- 补充诊断项:-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/path/to/dumps/(OOM 时自动生成堆转储);
- 若怀疑元空间问题,加上:-XX:+PrintGCDetails -XX:+PrintMetaspaceStatistics。
三、GC 日志关键字段速读指南
拿到 gc.log 后,不需逐行读,盯住这几列即可定位瓶颈:
- 时间戳 + GC 类型:如 2024-05-20T10:23:41.123+0800: [GC pause (G1 Evacuation Pause) (young) → 表示 G1 年轻代回收;[Full GC (Metadata GC Threshold) → 元空间不足触发 Full GC;
- 回收前/后堆大小:如 [Eden: 1024.0M(1024.0M)->0.0B(1024.0M) Survivors: 128.0M->128.0M Heap: 1524.0M(2048.0M)->524.0M(2048.0M)] → 堆从 1524M 降到 524M,说明回收有效;若降得少(如只降 20M),且频繁发生,大概率有对象存活时间过长或内存泄漏;
- 停顿时间(real time):如 [Times: user=0.03 sys=0.01, real=0.04 secs] → real 是 STW 时间,超过 200ms 就需关注,>1s 必须干预。
四、常见模式与应对动作
根据日志+监控交叉验证,快速匹配处理路径:
- 年轻代 GC 频繁(每秒多次),但每次回收快、堆使用率不高 → 检查是否创建了大量短生命周期小对象(如字符串拼接、临时集合),优化代码或适当调大年轻代(-Xmn);
- Full GC 频繁且由 Metadata GC Threshold 触发 → 增加元空间上限(-XX:MaxMetaspaceSize),并检查是否动态生成类过多(如反复 CGLIB 代理、Groovy 脚本热加载);
- G1 出现大量 “to-space exhausted” 或 “evacuation failure” → 说明并发标记跟不上分配速度,可调大 -XX:G1ReservePercent(默认 10%),或提前启动并发周期(-XX:G1HeapWastePercent=5);
- 堆转储(heap dump)中 java.lang.Class / char[] / byte[] 占比异常高 → 分别指向类加载器泄漏、字符串常量池膨胀、缓存未清理(如 Guava Cache 未设 size limit)。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










