在 java 9 及更高版本中，-xlog 参数用于统一配置垃圾回收日志的输出级别、标签和输出目标。通过指定 -xlog:gc* 可以启用默认的 gc 日志记录，而使用 -xlog:gc*:file=gc.log:time 可以将日志写入文件并包含时间戳。该参数支持细粒度的标签控制，例如仅记录 gc,heap+ref+age 相关的详细信息，从而帮助开发者精准排查内存问题。
如何配置 -Xlog 的基本输出格式与路径
要查看 GC 活动，最直接的方式是启用 gc 标签并将输出重定向到文件。默认情况下，如果不指定文件路径，日志会输出到标准错误流（stderr）。为了持久化分析，通常建议指定 file 属性。例如，命令 -Xlog:gc*:file=gc.log:tags,uptime 会在当前目录生成 gc.log 文件，其中包含标签信息和 JVM 启动后的运行时间。这种配置适用于大多数需要离线分析的场景。
// 编译示例 javac GcTest.java // 运行并开启详细 GC 日志到文件 java -Xlog:gc*:file=gc.log:tags,uptime GcTest
上述命令执行后，gc.log 将记录所有 GC 事件。若只需观察 Young GC，可使用 -Xlog:gc+young=debug。若需观察 Full GC，可使用 -Xlog:gc+full=debug。通过组合标签，可以过滤掉无关的日志噪音。
立即学习“Java免费学习笔记（深入）”；
如何使用 -Xlog 进行细粒度标签过滤
-Xlog 的强大之处在于其标签系统。GC 日志被划分为多个子标签，如 gc（通用）、heap（堆内存变化）、ref（引用处理）、age（晋升年龄）等。通过指定具体的标签组合，可以只关注特定阶段。例如，-Xlog:gc,heap+ref=info 仅记录堆内存分配和引用处理的 INFO 级别日志。这种细粒度控制在生产环境调试时非常有用，因为它能显著减少日志量，同时保留关键信息。
// 仅记录堆内存和引用处理的详细信息 java -Xlog:gc,heap+ref=debug GcTest
在实际操作中，如果发现内存泄漏，重点应关注 heap 标签中的堆大小变化趋势。如果怀疑对象未被正确回收，可结合 ref 标签查看引用链的处理情况。通过调整标签组合，可以快速定位问题根源。
当 -Xlog 输出中包含 'Promotion Failed' 时意味着什么
当 -Xlog 输出的日志中出现 Promotion Failed 警告时，意味着年轻代（Young Generation）中没有足够的连续空间来容纳即将晋升到老年代（Old Generation）的对象。这通常发生在对象突然大量晋升或老年代空间不足的情况下。此时，JVM 可能会触发一次 Mixed GC（G1 收集器）或 Full GC（Parallel/CMS 收集器），尝试清理老年代以腾出空间。如果频繁出现此警告，说明堆内存配置不合理，可能需要增大 -Xms 和 -Xmx，或者调整年轻代与老年代的比例。
