必须配置-xx:+heapdumponoutofmemoryerror和-xx:heapdumppath=/path/to/dumps/两个jvm参数，前者启用oom自动转储开关，后者指定绝对路径并确保jvm进程有写权限，可生成带进程号的java_pid12345.hprof文件或覆盖式oom.hprof。
Java 中设置堆内存溢出（OutOfMemoryError: Java heap space）时自动导出快照文件，核心是配置两个 JVM 启动参数，无需修改代码、不依赖外部工具，且零运行时开销。
必须配置的两个 JVM 参数
在启动 Java 应用时，将以下参数加入 JVM 选项中：
-
-XX:+HeapDumpOnOutOfMemoryError：启用 OOM 自动触发堆转储功能，这是开关项，不加则完全不生效 -
-XX:HeapDumpPath=/path/to/dumps/：指定保存路径，必须是绝对路径，且 JVM 进程对该目录有写权限
例如完整启动命令：java -Xmx512m -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/opt/app/logs/dumps/ -jar myapp.jar
路径写法影响文件命名和覆盖行为
-XX:HeapDumpPath 后接的内容决定生成方式：
- 接目录（如
/opt/app/dumps/）：JVM 自动生成带进程号的文件，例如java_pid12345.hprof，适合多实例或长期运行场景 - 接完整文件名（如
/opt/app/dumps/oom.hprof）：每次 OOM 都覆盖写入该文件，适合单实例调试，但会丢失历史快照
生产环境关键注意事项
参数生效不等于一定能成功落地，需提前验证以下三点：
-
磁盘空间充足：堆快照大小通常与堆上限（
-Xmx）接近，预留至少 1.2 倍空间 -
目录存在且可写：容器中需挂载宿主机卷（如
docker run -v /host/dumps:/opt/app/dumps），并确保 UID 匹配 -
文件生成后及时验证：OOM 触发后检查是否生成
.hprof文件，并用file xxx.hprof确认格式为 “Java HPROF dump”
辅助建议提升排查效率
单靠自动 dump 不够，建议搭配使用：
- 加
-XX:+PrintGCDetails -Xloggc:/path/gc.log，把 GC 日志和 dump 关联分析 - 容器中配合
--memory=2g限制内存，让 OOM 更早、更可控地发生 - 避免用
/tmp等易被清理路径；推荐挂载独立持久化存储卷
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
