Kubernetes容器内OpenJDK 11 Spring Boot服务堆内存配置不生效问题

配置不生效的核心原因 #

1. 过时JVM参数不兼容OpenJDK 11 #

你配置的-XX:+UseCGroupMemoryLimitForHeap、-XX:MaxRAMFraction是JDK 8u191之前版本的实验性参数，从JDK 10开始就已经被官方废弃移除，OpenJDK 11环境下这两个参数会被JVM直接忽略，完全不生效。
JDK 10及以上版本统一使用-XX:InitialRAMPercentage、-XX:MaxRAMPercentage、-XX:MinRAMPercentage三个参数适配容器cgroup内存限制。

2. 启动命令未引用JAVA_OPTS环境变量 #

大部分Spring Boot服务镜像的默认启动脚本不会自动读取JAVA_OPTS变量，如果你的Dockerfile中启动命令写为java -jar app.jar，没有显式拼接$JAVA_OPTS，你在deployment中配置的环境变量完全不会传递给JVM进程，相当于参数没配置。部分预制镜像默认读取的变量名是JAVA_OPTIONS而非JAVA_OPTS，也会导致配置失效。

3. 未配置容器内存限制导致JVM计算逻辑异常 #

如果你没有在deployment中给容器配置resources.limits.memory，JVM默认会读取宿主机的总内存计算堆大小，OpenJDK 11默认的MaxRAMPercentage值为25%，如果容器所在节点可用内存本身很小，或者K8s对容器做了隐式内存压制，就会出现实际堆内存远低于配置值的情况。

修复方案 #

1. 替换为适配OpenJDK 11的JVM参数：

env:
  - name: JAVA_OPTS
    value: "-Xms512M -Xmx512M -XX:+UseContainerSupport -XX:MaxRAMPercentage=75.0"

-XX:+UseContainerSupport是JDK 10+默认开启的容器支持参数，显式声明可避免兼容问题。

2. 给容器配置明确的内存限制，预留足够的非堆内存空间：

resources:
  limits:
    memory: "768Mi"
  requests:
    memory: "768Mi"

建议内存限制至少比堆内存大25%，留给堆外内存、元空间、JVM本身运行开销。

3. 确认镜像启动命令正确引用环境变量：
   修改Dockerfile启动命令为：
   ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar /app.jar"]
   如果使用第三方预制镜像，可以把环境变量名改为JAVA_OPTIONS，适配绝大多数镜像的默认读取规则。

内容的提问来源于stack exchange，提问作者user3322664