jdk 8及以前用-xx:+printgcdetails等经典参数，jdk 9+必须用-xlog统一配置，需显式指定time/uptime/tags并确保路径权限、文件未被轮转工具误删，否则日志静默失效。
Java GC 日志配置需区分 JDK 版本，核心是确保日志能完整记录回收类型、内存变化、停顿时间及触发原因，同时避免因权限、路径或参数冲突导致日志静默失效。
JDK 8 及以前：用经典组合参数
这套参数稳定兼容，适合老项目或需要快速验证的场景：
- -XX:+PrintGCDetails：必加，输出各代内存使用量、GC 类型（如 PSYoungGen/ParOldGen）、晋升大小、元空间变化等
- -XX:+PrintGCDateStamps：推荐加，以 2026-10-09T04:20:15.123+0800 格式标记时间，方便关联业务日志
- -Xloggc:/path/to/gc.log：必须指定路径，否则日志输出到控制台，生产环境极易丢失
- -XX:+PrintGCTimeStamps：可选，补充 JVM 启动后相对秒数（如 123.456），便于算间隔
- -XX:+PrintGCCause：显示触发原因（如 Allocation Failure、Metadata GC Threshold），排查根因更直接
- -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=10M：防止单文件过大撑爆磁盘
JDK 9 及以后：统一用 -Xlog，旧参数已废弃
JDK 9 起 -XX:+PrintGCDetails 被标记为 deprecated，JDK 10+ 默认禁用。继续使用会报警告且字段缺失、格式混乱。
- -Xlog:gc*:file=/data/logs/gc.log:time,uptime,tags,level：基础推荐写法，“gc*”表示启用所有 GC 子系统（heap、metaspace、age 等），time 和 uptime 必须显式声明，否则毫秒级精度丢失
- -Xlog:gc+pause=debug：专注 STW 停顿，精准输出每次暂停时长（如 Pause Young (Normal) 12.345ms）
- -Xlog:gc+heap=debug：查看 Eden/Survivor/老年代每次 GC 前后的 KB 级占用，判断分配速率和 Survivor 容量是否合理
- -Xlog:gc+metaspace=debug：区分是堆溢出还是元空间问题，避免误判 java.lang.OutOfMemoryError: Metaspace
- 不建议用 -Xlog:all=debug：日志量爆炸，I/O 拖慢 JVM，高并发下反而延长 STW
关键细节和常见坑
参数写对只是第一步，以下三点没处理好，日志可能“看似配置了，实则没生成”：
- 路径权限不足：比如指定 file=/var/log/app/gc.log，但 JVM 进程用户（如 appuser）对 /var/log/app/ 无写权限 → 日志静默失败，连 warning 都不报
- 日志文件被外部轮转工具删掉：logrotate 清空 gc.log 后，JVM 仍持有旧文件描述符（fd），新日志实际写入已删除文件的内核 buffer，最终丢弃
- 未指定输出目标，默认打到 stdout：容器环境常因 stdout 重定向或日志采集器截断导致内容不全；务必用 file=... 显式落盘
验证是否生效的小技巧
启动后快速确认日志是否正常生成：
- 检查文件是否存在且有内容：ls -l /path/to/gc.log && head -5 /path/to/gc.log
- 触发一次手动 GC（仅测试用）：jcmd
VM.runFinalization 或分配大对象逼出 Minor GC - 查最近 3 条停顿耗时（JDK 9+）：grep "Pause.*ms" gc.log | tail -3
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
