JDK 9起GC日志启用统一日志系统(-Xlog),核心结构含时间戳、标签组合、GC事件标识、内存变化字段及STW耗时;关键标签如gc+heap=debug、gc+metaspace=info等用于精准诊断,生产推荐配置兼顾可读性与稳定性。

JDK 9 起,GC 日志全面切换为统一日志系统(Unified JVM Logging),用 -Xlog 替代旧参数。格式不再杂乱,但结构更精细、标签更明确——关键不是“能不能看懂”,而是“有没有选对标签、配对装饰器”。
核心结构:时间戳 + 标签 + 事件 + 内存快照
一条典型日志长这样:
[2026-10-08T22:15:32.456+0800][678.234s][info][gc,start] GC(12) Pause Young (Normal)[2026-10-08T22:15:32.457+0800][678.235s][info][gc,heap] Eden: 1024M->0M(1024M) Survivors: 0B->128M Heap: 1536M->420M(2048M)
[2026-10-08T22:15:32.462+0800][678.240s][info][gc,time] GC(12) Pause Young: 5.8ms
-
时间戳:方括号里两个时间——绝对时间(如
2026-10-08T22:15:32.456+0800)和相对时间(如678.234s,JVM 启动后秒数)。后者更适合比对 STW 与应用线程栈。 -
标签组合:如
[gc,start]、[gc,heap]、[gc,time],说明该行日志属于哪个子维度。不是所有行都含完整信息,需按标签分组读。 -
GC 事件标识:
GC(12)表示第 12 次 GC;Pause Young是年轻代 STW 回收;(Normal)表示非紧急触发(区别于(Allocation Failure)或(G1 Evacuation Pause))。 -
内存变化字段:格式统一为
区域名: 使用前->使用后(总容量)。注意单位默认是字节,但日志中常简写为 K/M/G;Survivors: 0B->128M表示 Survivor 区从空变为占用 128MB,说明有对象晋升或复制成功。 -
耗时定位:
[gc,time]行给出精确 STW 时长(如5.8ms),比旧版real=...更直接可靠。
重点标签含义:不加它们,等于没开详细日志
只写 -Xlog:gc 只能看个“发生了 GC”,真正分析必须叠加子标签:
分析 Java Spring Boot 后端 Controller 代码,自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
gc+heap=debug:显示各代内存回收前后占用、容量、已提交大小。判断 Eden 是否总满、Survivor 是否溢出、老年代是否缓慢上涨的核心依据。 -
gc+metaspace=info:暴露元空间回收行为。出现Metaspace OOM时,靠它区分是类加载暴增还是回收失败。 -
gc+age=trace:打印对象年龄分布(如age 1: 120000B)。若 age 1 就大量进老年代,说明 Survivor 空间太小或MaxTenuringThreshold过低。 -
gc+pause:单独提取所有 STW 事件,方便统计停顿频次与时长分布,适配 APM 埋点或 Prometheus 抓取。 - 避免
gc*=debug或all=debug:日志量激增,I/O 压力大,高并发下可能反向拖慢 GC 本身。
常见问题对应的关键日志特征
不用工具也能快速识别几类典型问题:
-
频繁 Young GC:日志中
Pause Young出现密集(如每秒多次),且Eden总是→0M,但Heap回收后仍快速回升 → 很可能是对象创建速率过高,或新生代太小。 -
过早晋升:看
gc+age=trace行,发现age 1对象占比超 70%,同时Survivors在 GC 后几乎无增长 → Survivor 区太小,或对象“一出生就变老”(如大数组直接分配在老年代)。 -
元空间泄漏:
gc+metaspace=info显示used持续上涨、capacity不触发扩容、committed接近reserved→ 类加载器未释放,常见于热部署、OSGi 或反射生成类场景。 -
G1 混合回收异常:日志中出现大量
GC(XX) Pause Mixed,但Old区变化极小,Humongous区反复回收 → 大对象(> region 一半)频繁分配,引发内存碎片和额外开销。
配置建议:生产环境可直接套用
别从零拼参数。以下配置兼顾可读性、诊断力与稳定性:
-Xlog:gc+heap=debug,gc+metaspace=info,gc+age=trace,gc+pause:file=/data/logs/gc.log:time,uptime,tid,level,tags:filecount=32,filesize=64m- 说明:
gc+heap=debug看堆变化,gc+metaspace=info防 Metaspace 误判,gc+age=trace辅助调参,gc+pause单独拎出停顿;time,uptime,tid支持多线程上下文对齐;filecount=32,filesize=64m防止单文件爆炸。










