JVM内存占用超过指定阈值时自动生成heap dump的实现方法

你提到的三种实现路径都可行，可根据自身需求选择：

1. 直接使用JVM内置启动参数（最省心，无需额外工具/代码） #

如果你的阈值就是JVM最大堆内存（即-Xmx参数配置的阈值），可以直接使用HotSpot VM的内置参数，当堆内存耗尽触发OutOfMemoryError时自动生成堆转储文件：

• 核心参数：
  • +XX:HeapDumpOnOutOfMemoryError：开启OOM时自动生成heap dump的能力
  • XX:HeapDumpPath=/自定义路径/heap.hprof：指定dump文件的存储路径，可拼接时间戳避免文件覆盖
• 启动示例：

  java -Xmx2048m -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=./heapdump.hprof -jar your-application.jar
  

  上述配置下，JVM堆内存超过2048MB触发OOM时，会自动在当前目录生成heapdump.hprof文件。

2. 使用外部工具/脚本（无需修改业务代码和启动参数） #

如果需要自定义非OOM的阈值，或者不想修改已有Java进程的启动配置，可以用外部脚本/工具实现：

• 最简单的方案是编写定时shell脚本：通过jstat -gc 进程ID定时获取堆内存使用量，超过你设置的阈值后，调用jmap命令生成dump：

  # 示例脚本逻辑，需将1234替换为实际Java进程ID
  USED_MEM=$(jstat -gc 1234 | awk 'NR==2{print $3+$4+$6+$8}' | xargs printf "%.0f")
  THRESHOLD=$((1800*1024)) # 阈值设置为1800MB
  if [ $USED_MEM -gt $THRESHOLD ]; then
    jmap -dump:format=b,file=./heap_$(date +%Y%m%d%H%M%S).hprof 1234
  fi
  

• 也可以用Arthas这类Java诊断工具，动态attach到运行中的JVM进程，配置内存阈值触发dump，无需修改原有进程的任何配置。

3. 自行编码实现（最高灵活性，支持自定义触发逻辑） #

如果需要更复杂的触发规则，比如超过阈值连续3次才生成dump、生成dump同时推送告警、只统计指定内存区域的占用量，可以自行通过JMX接口实现：

1. 通过MemoryPoolMXBean获取对应内存区域（如老年代、年轻代）的使用情况，设置自定义阈值
2. 注册内存阈值超标的监听器，触发时调用HotSpotDiagnosticMXBean的dumpHeap方法生成堆转储文件
3. 代码示例片段：

   // 获取老年代内存池
   Optional<MemoryPoolMXBean> oldGenPool = ManagementFactory.getMemoryPoolMXBeans().stream()
           .filter(pool -> pool.getType() == MemoryType.HEAP && pool.isUsageThresholdSupported())
           .filter(pool -> pool.getName().contains("Old") || pool.getName().contains("Tenured"))
           .findFirst();
   if (oldGenPool.isPresent()) {
       MemoryPoolMXBean pool = oldGenPool.get();
       pool.setUsageThreshold(1800 * 1024 * 1024); // 设置阈值为1800MB
       // 注册阈值超标监听器
       NotificationEmitter emitter = (NotificationEmitter) ManagementFactory.getMemoryMXBean();
       emitter.addNotificationListener((notification, handback) -> {
           if (MemoryNotificationInfo.MEMORY_THRESHOLD_EXCEEDED.equals(notification.getType())) {
               HotSpotDiagnosticMXBean diagnostic = ManagementFactory.getPlatformMXBean(HotSpotDiagnosticMXBean.class);
               diagnostic.dumpHeap("./heap_" + System.currentTimeMillis() + ".hprof", true);
           }
       }, null, null);
   }
   

方案选择建议 #

• 仅需要OOM时生成dump：选内置启动参数方案，生产环境最常用
• 不想修改原有进程的配置/代码：选外部工具/脚本方案
• 有特殊自定义触发逻辑需求：选自行编码方案

内容的提问来源于stack exchange，提问作者Kamil W