排查 java 堆外内存泄漏,核心思路是监控进程总内存(rss)与堆内内存的差值,定位到具体的堆外分配器,并通过 dump 或源码分析找到未释放的对象。具体做法是先通过 jcmd 或 jstat 确认是否存在堆外内存异常增长,接着使用 nativememorytracking (nmt) 查看各组件的详细占用,最后结合 jmap -dump:format=b,file=heap.hprof 导出堆转储文件,在 mat 等工具中利用 histogram 和 dominator tree 筛选出疑似持有大量堆外引用的对象,从而锁定泄漏源头。

如何判断当前应用是否存在堆外内存泄漏
判断堆外内存泄漏最直接的方法是观察进程的 Resident Set Size (RSS) 与 JVM 堆内存使用量之间的差异。如果 RSS 持续增长且远超堆内存上限,同时 Full GC 无法回收这部分内存,则极大概率存在堆外泄漏。可以通过 jcmd <pid> VM.native_memory summary</pid> 命令获取详细的 Native Memory Tracking 信息,重点关注 External 和 Tracked 类别下的内存变化趋势。此外,Linux 系统下的 pmap -x <pid></pid> 命令可以列出进程的所有内存映射区域,其中 anon 类型的区域通常对应堆外内存,若发现某些匿名内存区域持续增大且不释放,即可确认为泄漏迹象。

import java.lang.management.ManagementFactory;
import com.sun.management.OperatingSystemMXBean;
public class HeapOffHeapMonitor {
public static void main(String[] args) throws Exception {
OperatingSystemMXBean osBean = ManagementFactory.getPlatformMXBean(OperatingSystemMXBean.class);
long totalPhysicalMemory = osBean.getTotalPhysicalMemorySize();
long freePhysicalMemory = osBean.getFreePhysicalMemorySize();
long usedPhysicalMemory = totalPhysicalMemory - freePhysicalMemory;
// 获取 JVM 堆内存使用情况
java.lang.management.MemoryMXBean memoryMXBean = ManagementFactory.getMemoryMXBean();
long heapUsed = memoryMXBean.getHeapMemoryUsage().getUsed();
long nonHeapUsed = memoryMXBean.getNonHeapMemoryUsage().getUsed();
System.out.println("Total Physical Memory: " + totalPhysicalMemory);
System.out.println("Used Physical Memory (RSS approx): " + usedPhysicalMemory);
System.out.println("JVM Heap Used: " + heapUsed);
System.out.println("JVM Non-Heap Used: " + nonHeapUsed);
System.out.println("Estimated Off-Heap Memory: " + (usedPhysicalMemory - heapUsed - nonHeapUsed));
// 模拟堆外内存分配
java.nio.ByteBuffer buffer = java.nio.ByteBuffer.allocateDirect(1024 * 1024 * 10); // 10MB
Thread.sleep(60000); // 保持引用
}
}
如何利用 NMT 定位堆外内存的具体来源
一旦确认存在堆外内存泄漏,下一步是利用 Native Memory Tracking (NMT) 来细化定位。需要在启动参数中添加 -XX:NativeMemoryTracking=detail 以开启详细跟踪。随后运行 jcmd <pid> VM.native_memory detail</pid>,输出会按 Metaspace, Thread, GC, Internal, External 等分类展示内存分布。重点检查 External 部分,这里通常包含 DirectByteBuffer、JNI 调用分配的内存以及第三方库(如 Netty、LZ4)的堆外分配。如果发现某个特定模块(如 Netty 或 Unsafe)的 Reserved 或 Committed 内存显著高于其他部分,说明该模块是泄漏的主要嫌疑对象。对于 DirectByteBuffer,还需注意其底层依赖的 sun.misc.Unsafe 或 VarHandle 操作是否被正确清理。
使用 Husky 将 pre-commit、pre-push 和 commit-msg 检查集成到仓库中,以便代理和开发人员在更改离开工作站之前运行相同的本地防护措施。
立即学习“Java免费学习笔记(深入)”;

// 假设我们怀疑 Netty 导致泄漏,通过 NMT 发现 External 内存高
// 以下代码演示如何手动管理 DirectByteBuffer 以避免泄漏
import java.nio.ByteBuffer;
public class DirectByteBufferLeakDemo {
public static void main(String[] args) {
// 错误的做法:仅创建引用,未确保释放
ByteBuffer buffer = ByteBuffer.allocateDirect(1024 * 1024 * 100); // 100MB
// 正确的做法:在使用完毕后显式清理或确保引用被垃圾回收
// 对于 DirectByteBuffer,JVM 会通过 Cleaner 机制在 GC 时尝试释放
// 但如果存在强引用链未断开,Cleaner 不会被执行
buffer = null; // 解除引用,允许 GC 回收
System.gc(); // 强制 GC 触发 Cleaner
try { Thread.sleep(1000); } catch (Exception e) {}
// 验证:此时堆外内存应已释放
System.out.println("Direct Buffer allocated and released.");
}
}
如何通过堆转储文件分析持有堆外内存的对象
当 NMT 指向了大致范围后,需要通过堆转储(Heap Dump)进行最终确认。使用 jmap -dump:live,format=b,file=heap.hprof <pid></pid> 导出堆转储文件,并在 Eclipse MAT 中打开。在 MAT 中,首先运行 Histogram 查看对象数量,然后切换到 Dominator Tree 视图,按对象大小排序。由于堆外内存本身不在堆内,我们需要寻找那些可能持有堆外内存引用的 Java 对象。常见的嫌疑对象包括 java.nio.DirectByteBuffer 本身,或者自定义的缓存类、网络缓冲区池等。在 Dominator Tree 中,选中疑似对象,右键选择 Path to GC Roots -> with excluded references,查看其引用链。如果发现有大量的 DirectByteBuffer 对象被某个特定的集合或静态变量持有,且这些对象不再被业务逻辑使用,则确认了泄漏点。此外,MAT 的 Leak Suspects Report 也会自动提示潜在的内存泄漏路径,结合 NMT 的结果进行交叉验证,可以精确定位到具体的代码行。

















