直接内存（direct memory）无法通过标准的jvm堆参数（如-xmx）进行监控，因为它属于堆外内存。要监控它，必须依赖java nio的`bytebuffer.allocatedirect()`机制，并结合`java.lang.management.memorymxbean`获取`nonheapmemoryusage`中的`committed`值变化，或者使用jdk自带的`jcmd`工具查看`gc.heap_info`和`nativememorytracking`统计信息。
如何通过代码API获取直接内存的使用量
在Java 9之前，开发者通常需要通过反射调用`Unsafe`或`Cleaner`来估算直接内存的使用情况，但这非常不稳定且容易出错。从Java 9开始，官方提供了更稳定的方式，即通过`BufferPoolMXBean`来获取直接内存缓冲区的数量和总容量。这是最直接的编程式监控手段。
以下是一个完整的示例程序，演示如何获取当前JVM中直接内存缓冲区的数量、总容量以及已分配的直接内存字节数。该程序使用了`ManagementFactory`来获取系统管理bean，并遍历所有已知的缓冲区池。
import java.lang.management.BufferPoolMXBean;
import java.lang.management.ManagementFactory;
import java.lang.management.MemoryMXBean;
import java.lang.management.MemoryUsage;
import java.nio.ByteBuffer;
import java.util.List;
public class DirectMemoryMonitor {
public static void main(String[] args) throws Exception {
// 1. 获取内存管理器
MemoryMXBean memoryMXBean = ManagementFactory.getMemoryMXBean();
// 2. 获取缓冲区池管理器
List<BufferPoolMXBean> bufferPools = ManagementFactory.getPlatformMBeans();
System.out.println("=== 直接内存监控报告 ===");
for (BufferPoolMXBean pool : bufferPools) {
if ("direct".equals(pool.getName())) {
long count = pool.getCount();
long capacity = pool.getMemoryUsed();
System.out.println("直接内存缓冲区数量: " + count);
System.out.println("直接内存已使用容量(字节): " + capacity);
System.out.println("直接内存总容量(字节): " + pool.getTotalCapacity());
}
}
// 3. 模拟分配一些直接内存以验证监控数据
ByteBuffer directBuffer = ByteBuffer.allocateDirect(1024 * 1024); // 1MB
Thread.sleep(1000);
// 重新查询以观察变化
for (BufferPoolMXBean pool : bufferPools) {
if ("direct".equals(pool.getName())) {
System.out.println("--- 分配1MB后 ---");
System.out.println("直接内存已使用容量(字节): " + pool.getMemoryUsed());
}
}
// 清理资源
directBuffer.clear();
}
}
运行上述代码，你将看到控制台输出直接内存的使用情况。当执行`allocateDirect`时，`getMemoryUsed()`的值会相应增加。这种方法适用于需要在应用内部实时了解直接内存占用情况的场景。
立即学习“Java免费学习笔记（深入）”；
如何使用命令行工具监控直接内存
除了代码层面的监控，运维和排查问题时更常用的是命令行工具。JDK提供的`jcmd`是监控JVM状态的首选工具，特别是`VM.native_memory`功能，它可以提供比`BufferPoolMXBean`更详细的底层内存分布信息。
首先，启动你的Java应用时需要开启本地内存跟踪（NMT）。可以通过添加JVM参数`-XX:+UnlockDiagnosticVMOptions -XX:+PrintNativeMemory -XX:NativeMemoryTracking=detail`来启用。然后，使用`jcmd`连接到目标进程。
// 假设进程ID为 12345 jcmd 12345 VM.native_memory summary
执行上述命令后，输出中将包含一个名为`Internal`或`External`的区域，其中详细列出了`Arena`、`Chunk`等结构。对于直接内存，重点关注`Direct Memory`部分。它会显示分配的字节数、保留的字节数以及峰值使用情况。如果未开启NMT，可以使用`jcmd 12345 GC.heap_info`查看堆信息，但它不直接显示直接内存。另一种方式是使用`jstat -gcutil
直接内存溢出时的具体表现与排查
当直接内存耗尽时，JVM不会抛出`OutOfMemoryError: Java heap space`，而是抛出`OutOfMemoryError: Direct buffer memory`。这通常发生在`ByteBuffer.allocateDirect()`调用失败时。此时，即使堆内存充足，程序也会崩溃。
为了复现和排查这个问题，我们可以修改之前的监控程序，强制分配大量直接内存直到触发异常。这将帮助开发者理解直接内存溢出的具体触发条件和错误信息格式。
import java.nio.ByteBuffer;
import java.util.ArrayList;
import java.util.List;
public class DirectMemoryOOMDemo {
public static void main(String[] args) {
List<ByteBuffer> buffers = new ArrayList<>();
try {
while (true) {
// 每次分配1MB的直接内存
ByteBuffer buffer = ByteBuffer.allocateDirect(1024 * 1024);
buffers.add(buffer);
System.out.println("已分配 " + buffers.size() + " MB 直接内存");
}
} catch (OutOfMemoryError e) {
System.err.println("捕获到直接内存溢出异常: " + e.getMessage());
// 在这里可以记录日志或进行其他清理工作
}
}
}
运行此程序，你将看到大量的"已分配...MB直接内存"输出，最终抛出`java.lang.OutOfMemoryError: Direct buffer memory`。这表明直接内存池已满。此时，检查`BufferPoolMXBean`会发现`getMemoryUsed()`接近JVM启动时设置的`-XX:MaxDirectMemorySize`（默认为物理内存大小，除非显式指定）。排查此类问题时，应检查是否有未释放的直接内存引用，或者是否应该限制最大直接内存大小。
