JDK 11起GC日志统一由-Xlog接管,支持按标签(如gc、gc+heap)、级别、装饰器和输出目标精细控制,语法为-Xlog:<tags>[:<level>[:<output>]。

JDK 11 起,-XX:+PrintGCDetails 等旧参数已被废弃,统一由 -Xlog 框架接管。它更灵活、结构化,支持按标签(tag)、级别(level)、输出目标等精细控制。
核心语法格式:-Xlog[:<tags>[:<level>][:<decorators>][:<output>]]
其中 <tags> 是关键,GC 相关日志主要依赖以下常用组合:
-
gc:基础 GC 事件(如 GC 触发、类型、耗时、内存变化) -
gc+heap:堆内存布局与使用详情(如各代大小、已用/可用空间) -
gc+metaspace:元空间分配与回收行为 -
gc+age:对象年龄分布(尤其对 G1/ZGC 判断晋升策略有用) -
gc+phases:GC 阶段耗时分解(如 mark、evacuate、relocate) -
gc+ref:软/弱/虚引用处理过程
典型实用配置示例:
立即学习“Java免费学习笔记(深入)”;
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
基础可观测性(推荐上线默认):
-Xlog:gc*:file=gc.log:time,uptime,level,tags:filecount=5,filesize=50M查看 ZGC 的重定位是否生效(验证染色指针链路):
-Xlog:gc,relocate=debug:file=zgc-reloc.log:time,uptimeG1 调优时细查停顿原因:
-Xlog:gc,gc+phases,gc+heap=debug:file=g1-detail.log:time,uptime,tags同时输出到控制台和文件(调试阶段方便快速观察):
-Xlog:gc=info:stdout:time,uptime,tags -Xlog:gc=info:file=gc.log:time,uptime,tags:filecount=3,filesize=20M
注意几个关键点:
- 多个
-Xlog可共存,互不冲突;也可用逗号分隔多个 tag,如gc,heap,metaspace -
level默认是info;debug和trace提供更细粒度,但会显著增加日志量和 I/O 开销 -
decorators(如time,uptime,tags,pid,tid)建议至少保留time和uptime,便于关联业务日志 - 文件滚动必须显式指定
filecount和filesize,否则默认不轮转,单文件无限增长
验证是否生效:
启动后检查日志文件头是否有 [0.000s][info][gc] Using G1 或 [0.001s][info][gc,relocate] Relocating 12.4G... 这类带明确 tag 和时间戳的行。没有则说明配置有误或 JVM 未识别该 tag 组合。

















