必须指定-xx:heapdumppath路径，否则默认写入工作目录易因权限、清理或空间问题导致dump丢失；推荐动态路径如/opt/app/logs/oom_%p_%t.hprof并确保目录可写。
加上 -XX:+HeapDumpOnOutOfMemoryError 参数后，JVM 在发生 OOM 时会自动生成堆转储文件（heap dump），这是定位内存问题最直接有效的手段之一。关键不是“加了就行”，而是要配对指定输出路径、确保磁盘可写、并兼顾线上环境的稳定性。
必须指定 dump 文件保存路径
单独启用 -XX:+HeapDumpOnOutOfMemoryError 不会生成文件——它默认尝试写到启动目录下，而生产环境往往无写权限或路径不可控，导致 dump 失败却无声无息。
- 推荐写法：
-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/opt/app/logs/heapdump.hprof - 支持动态路径占位符：用
%p表示进程 PID，%t表示时间戳（秒级），例如：-XX:HeapDumpPath=/opt/app/logs/oom_%p_%t.hprof，避免多实例覆盖 - 路径所在目录需提前创建，并赋予 JVM 进程用户读写权限（如
chown admin:admin /opt/app/logs）
建议搭配 -XX:+PrintGCDetails 和 -XX:+PrintGCTimeStamps
OOM 往往伴随 GC 频繁或失败，这些参数能让日志中记录每次 GC 的详细信息和时间点，便于和 dump 文件时间对齐分析。
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 示例组合：
-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/opt/app/logs/oom_%p_%t.hprof -XX:+PrintGCDetails -XX:+PrintGCTimeStamps - GC 日志建议重定向到独立文件，如：
-Xloggc:/opt/app/logs/gc.log（JDK 9+）或-XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=10M（防日志撑爆磁盘）
注意 JDK 版本差异与元空间适配
JDK 8 及之前使用 -XX:MaxPermSize，JDK 9 起永久代被元空间（Metaspace）替代；OOM 类型不同，但 dump 参数通用。若遇到 java.lang.OutOfMemoryError: Metaspace，同样触发该配置生成 heap dump（注意：它不包含元空间内容，但能反映类加载器引用链）。
- JDK 8 示例：
-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/data/dump/ - JDK 17+ 推荐补充：
-XX:+UseStringDeduplication（减少字符串重复占用）和-XX:NativeMemoryTracking=summary（辅助排查直接内存问题） - 容器环境（如 Docker）中，路径需映射到宿主机，且确保 volume 有足够空间（dump 文件常达数 GB）
验证配置是否生效
启动后检查 JVM 参数是否加载成功：
- 执行
ps -ef | grep java，确认命令行中含完整-XX:+HeapDumpOnOutOfMemoryError及-XX:HeapDumpPath - 故意触发一次 OOM（如循环 new byte[1MB]），观察目标路径是否生成
.hprof文件 - 用
jmap -histo <pid></pid>或jstat -gc <pid></pid>辅助判断堆使用趋势，提前预警
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
