📚 课程目录第4章自动触发Dump的配置

4. 自动触发Dump的配置：JVM参数、Dump路径、文件大小、轮转策略

4.1 现象识别

当应用出现 OutOfMemoryError (OOM) 时，JVM 默认不会自动导出 Heap Dump，导致事后无法分析内存泄漏现场。典型现象包括：

生产系统突然挂死，日志仅显示 java.lang.OutOfMemoryError: Java heap space 或 GC overhead limit exceeded，但无 Dump 文件。
运维人员手动执行 jmap -dump 时错过最佳时机，堆已被回收或进程已退出。
配置了 Dump 但路径不存在或磁盘写满，Dump 生成失败且无告警。

⚠ 关键判断规则： 若应用重启后 OOM 重现且无 Dump 文件，则 90% 是因为未配置自动触发参数或路径权限不足。

4.2 数据采集

检查目标 JVM 进程的启动参数，确认是否包含以下关键配置：

JVM 参数	用途	缺失后果
`-XX:+HeapDumpOnOutOfMemoryError`	OOM 时自动导出 Heap Dump	不生成 Dump
`-XX:HeapDumpPath=/path/to/dumps`	指定 Dump 文件输出路径	写入 JVM 工作目录，可能丢失
`-XX:HeapDumpAfterFullGC=1` (JDK 14+)	Full GC 后自动 Dump（用于 GC 问题排查）	仅能在 OOM 时触发，错失 GC 异常数据
`-XX:+ExitOnOutOfMemoryError`	OOM 时强制退出进程	进程挂死，健康检查无法恢复

  📊 排查表：自动 Dump 配置检查清单
  确认 JVM 启动参数是否包含 +HeapDumpOnOutOfMemoryError。
查看 HeapDumpPath 目录是否存在、是否可写、剩余磁盘空间是否大于最大堆（建议预留 2 倍堆大小）。
检查是否有轮转策略（如 -XX:NumberOfGCLogFiles 或外部脚本），避免单个 Dump 文件过大撑爆磁盘。
验证 OOM 触发后 Dump 文件 是否成功生成（可模拟 OOM 测试环境确认）。

4.3 原因定位

未生成 Dump 或生成失败的常见原因：

参数遗漏： 启动脚本未加 -XX:+HeapDumpOnOutOfMemoryError。
路径权限不足： 进程用户对目标目录无写权限，或路径不存在。
磁盘空间不足： Dump 文件生成时磁盘写满，导致 JVM 退出且无文件。
文件命名冲突： 多个进程共用同一路径且未使用 %p 或 %t 占位符，导致覆盖。

# 正确配置示例（Oracle JDK 8+ / OpenJDK 8+）
-XX:+HeapDumpOnOutOfMemoryError
-XX:HeapDumpPath=/opt/logs/heapdumps/java_pid%p.hprof
-XX:+ExitOnOutOfMemoryError

# 对于 JDK 17+ 推荐增加 Full GC 触发
-XX:HeapDumpAfterFullGC=1
-XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=20M   # GC 日志轮转，非 Dump 轮转

# Dump 文件轮转需通过外部 cron 或前处理脚本来实现
# 例如：修改 HeapDumpPath 指向符号链接，定期重新创建软链并清理旧 Dump

4.4 修复动作

添加遗漏参数： 在 JAVA_OPTS 中追加 -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/path/to/dumps。
确保路径存在且可写： mkdir -p /path/to/dumps && chown appuser:appgroup /path/to/dumps
配置磁盘监控： 设置 df 告警，当剩余空间小于堆大小 3 倍时触发 PagerDuty/钉钉。
实现轮转策略（可选）： 编写 cron 脚本定期清理超过 30 天的 Dump 文件，或使用 logrotate 按大小/时间轮转。

💡 稳健方案： 对于高可用集群，推荐将 Dump 文件输出到共享存储（如 NFS 或 EFS），并设置 OOM 时自动终止容器（K8s 中设置 restartPolicy: Never + 保留 Dump 在宿主机的持久卷）。

4.5 复测

模拟 OOM 场景：使用 jcmd <pid> GC.heap_dump 或 jmap -dump:live,format=b,file=/tmp/test.hprof <pid> 验证 Dump 功能正常。
强制触发 OOM：在小堆测试容器中运行持续分配对象的代码，观察 HeapDumpOnOutOfMemoryError 是否生效。
检查 Dump 文件生成时间与进程退出时间之差应< 2秒，且文件格式为 hprof，大小与堆一致。

4.6 预防

将自动 Dump 参数纳入公司级 JVM 启动模板，通过配置管理工具（Ansible/Chef）统一下发。
建立 Dump 文件生命周期管理：保留最近 7 天的 Dump，并用 symlink 指向最新 Dump 以便快速获取。
定期巡检 Dump 目录磁盘使用量，结合监控告警。
在 CI/CD 流程中集成 OOM 模拟测试，确保每次发布前的启动参数正确。