不设-XX:MaxDirectMemorySize即无限制，JVM默认按-Xmx推算但不校验容器限制；设为0禁止分配，设具体值（如512m）才是生产唯一可靠方式，须结合容器limit、堆内存、元空间等预留后精确计算。
不设 -XX:MaxDirectMemorySize 就等于没限制
默认情况下，JVM 并不会主动限制堆外内存（Direct Buffer）的使用总量。虽然 JDK 8+ 的默认值名义上是 -Xmx 的大小，但这个“默认”只在 JVM 启动时读取一次，且**不校验实际物理内存或容器限制**——也就是说，如果你跑在 2GB 容器里、-Xmx=1g，JVM 仍可能默许分配接近 1GB 的 Direct Buffer，叠加堆内、元空间、CodeCache 后极易触发 OOM Killer 杀进程。
真正起作用的只有显式配置的 -XX:MaxDirectMemorySize。没写这行参数，就等于把堆外内存的闸门完全敞开。
- 不设该参数 → JVM 用
VM.maxDirectMemory()自行推算，默认逻辑复杂且易误判（比如在 Docker 中可能按宿主机内存算） - 设为
0→ 显式禁止任何ByteBuffer.allocateDirect()调用，会直接抛OutOfMemoryError: Direct buffer memory - 设为具体值（如
512m）→ 才是生产环境唯一可靠的限制方式
怎么配才不踩容器和 Netty 的坑
在 Kubernetes 或 Docker 环境中，光写 -XX:MaxDirectMemorySize=1g 很可能还是错的——因为你的容器内存 limit 是 4GB，但 JVM 堆（-Xmx）占了 2.5G，元空间、CodeCache、线程栈加起来近 500MB，再给 1G 堆外，总内存就超限了。
更糟的是，Netty 默认每连接分配 64KB Direct Buffer，1000 个连接就是 64MB；如果还开了堆外缓存（如 PooledByteBufAllocator），实际占用会远高于配置值。
- 推荐做法：堆外内存上限 ≤ 容器内存 limit −
-Xmx−-XX:MaxMetaspaceSize−-XX:ReservedCodeCacheSize− 200MB（预留系统开销） - 示例（8C16G 容器，limit=12G）：
-Xmx6g -XX:MaxMetaspaceSize=512m -XX:ReservedCodeCacheSize=256m -XX:MaxDirectMemorySize=3g - 务必配合
-XX:+UseContainerSupport（JDK 8u191+），否则-Xmx和-XX:MaxDirectMemorySize都可能无视容器限制
-XX:MaxDirectMemorySize 和 ByteBuffer.allocateDirect() 的真实关系
这个参数管的不是“已分配”的字节数，而是“累计申请容量”的上限。JVM 内部用一个原子计数器 totalCapacity 累加每次 allocateDirect() 的 cap 参数值，一旦超过 maxMemory 就拒绝分配。
注意：它不管这些 buffer 是否已被 GC 或清理（Cleaner 回收是异步的），也不管操作系统是否真把内存交出来——所以你看到 top 里 RSS 没涨，但照样会 OOM。
- 错误认知：“我只用了几个 DirectBuffer，不可能超” → 实际可能是连接池反复创建未释放，
totalCapacity持续累加 - 调试技巧：加
-XX:+PrintGCDetails并观察日志里是否出现Direct buffer memory错误；用jcmd查看实时 direct memory 使用量VM.native_memory summary - 单位必须明确：写
2G和2g都行，但2（无单位）会被当成字节，直接失效
Spring Boot 启动脚本里最容易漏写的那一行
很多人在 application.yml 里调线程池、调数据库连接数，却忘了 JVM 参数根本进不了 Spring Boot 的配置体系——spring.* 属性对 -XX: 参数完全无效。
最稳妥的方式是在启动脚本里拼到 JAVA_OPTS，而不是依赖 IDE 运行配置或 java -jar 命令行手敲（容易遗漏或写错位置）。
- Linux
.sh脚本中正确写法：export JAVA_OPTS="-Xms2g -Xmx2g -XX:MaxDirectMemorySize=1g" - 错误写法：
java $JAVA_OPTS -jar app.jar但忘了定义JAVA_OPTS；或写成java -jar app.jar $JAVA_OPTS（参数顺序错，JVM 不识别） - Dockerfile 中应写在
ENTRYPOINT或CMD之前，确保被 shell 正确展开
JVM 堆外内存限制这事，表面是一行参数，背后连着容器内存、框架行为、GC 时机和系统回收延迟四层变量。少设、错设、晚设，都会让 OOM 来得又快又静。
