Spring Boot 容器内存优化：JVM 堆、非堆与 MaxRAMPercentage

容器内存不是全部给 Java 堆使用。Metaspace、线程栈、Direct Buffer、JIT Code Cache、JNI、本地库和系统开销都会占用非堆内存。堆设置过大容易触发 OOMKilled。

解决方案思路

按容器 limit 拆分预算：堆、非堆、直接内存、线程栈和安全余量。使用 MaxRAMPercentage 或固定 Xmx，但必须结合 NMT、GC 日志和容器内存曲线验证。

容器内 JVM 内存参数示例

JAVA_OPTS="-XX:MaxRAMPercentage=65 -XX:InitialRAMPercentage=65 \
  -XX:MaxMetaspaceSize=256m -XX:MaxDirectMemorySize=256m \
  -Xss512k -Xlog:gc*:file=/logs/gc.log"

运行逻辑

运行时 RSS 会大于 Java 堆使用量。线程数、Netty 直接内存、类加载和 JIT 都可能让容器内存逼近 limit，所以内存优化要同时看 JVM 和容器两套指标。

重点观察指标

• container_memory_working_set_bytes
• jvm.memory.heap/nonheap、direct buffer
• OOMKilled 次数与 GC 日志末端

常见误区

• 只设置 Xmx 不预留非堆
• 线程池过大导致线程栈总量失控
• 容器 limit 调整后 JVM 参数没有同步更新

参考方案

• Oracle Java 21 GC Tuning Guide
• Java Native Memory Tracking

上线检查

• 优化前后保留同一口径的指标截图或报告。
• 先灰度单实例或小流量，观察 P95/P99、错误率和资源指标。
• 准备回滚开关，避免性能改动影响核心业务。