直接内存溢出(direct memory outofmemoryerror)通常由 java.nio.bytebuffer.allocatedirect() 分配超出系统限制或剩余堆外内存的字节缓冲区引发。要复现此问题,需通过 jvm 参数 -xx:maxdirectmemorysize 显式设置一个较小的上限值,并在代码中循环分配大于该值的 directbytebuffer,从而触发 java.lang.outofmemoryerror: direct buffer memory。

如何通过JVM参数控制直接内存大小
直接内存的大小默认等于 Java 堆的最大值(-Xmx),但可以通过 -XX:MaxDirectMemorySize 参数进行独立限制。在排查此类问题时,开发者首先需要确认当前进程允许使用的最大直接内存量。如果未指定该参数,JVM 会将其视为与堆内存相同;若指定了具体数值,则所有通过 NIO 分配的堆外内存总和不能超过此阈值。理解这一参数的作用范围是定位问题的第一步,它决定了程序在触及 OOM 之前能“消耗”多少物理内存。

public class DirectMemoryDemo {
public static void main(String[] args) {
// 设置最大直接内存为 10MB
System.setProperty("maxDirectMemory", "10485760");
try {
// 尝试分配 11MB 的直接内存,超过限制
ByteBuffer buffer = ByteBuffer.allocateDirect(11 * 1024 * 1024);
} catch (OutOfMemoryError e) {
System.out.println("捕获异常: " + e.getMessage());
}
}
}
为什么NIO分配会抛出特定类型的OOM
当直接内存分配失败时,JVM 抛出的异常类型非常明确,即 java.lang.OutOfMemoryError: Direct buffer memory。这与普通的堆内存溢出(Java heap space)不同,因为 DirectByteBuffer 对象本身虽然存在于 Java 堆中,但其实际承载数据的内存位于堆外。这种设计使得 NIO 能够绕过 GC 对堆内对象的频繁回收压力,直接利用操作系统级别的内存管理。然而,这也意味着如果开发者不手动释放这些堆外内存,或者分配速度超过了垃圾回收器清理引用队列的速度,就会迅速耗尽预留的堆外空间。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

import java.nio.ByteBuffer;
import java.lang.reflect.Field;
public class DirectMemoryLeakDemo {
public static void main(String[] args) throws Exception {
// 模拟持续分配导致溢出
int count = 0;
while (true) {
try {
ByteBuffer.allocateDirect(1024 * 1024); // 每次分配 1MB
count++;
} catch (OutOfMemoryError e) {
System.out.println("在第 " + count + " 次分配后发生溢出");
break;
}
}
}
}
如何验证直接内存是否被正确回收
为了验证直接内存的回收机制,可以观察 DirectByteBuffer 的终结器行为。当堆内的 DirectByteBuffer 对象被 GC 回收时,其关联的堆外内存并不会立即释放,而是通过一个引用队列(ReferenceQueue)异步通知 Cleaner 线程去执行实际的内存释放操作。如果在高并发或高频分配场景下,堆外内存的释放速度跟不上分配速度,即使堆内对象已被回收,依然可能触发直接内存溢出。因此,监控堆外内存的使用情况对于维护基于 NIO 的高性能应用至关重要。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










