在Java Docker镜像中使用JAVA_OPTS设置-Xmx参数无效？

你的问题核心是ENTRYPOINT配置未引用JAVA_OPTS环境变量，导致你设置的-Xmx参数根本没被JVM加载。默认情况下，OpenJDK 17会自动适配Docker容器的--memory限制，自动计算堆内存大小（通常为容器内存的1/4，比如2GB容器内存对应512MB堆内存，和你看到的536870912字节一致）。

解决方法与可用环境变量 #

1. 让JAVA_OPTS生效

修改Dockerfile中的ENTRYPOINT，让它读取JAVA_OPTS变量：

FROM openjdk:17
COPY ./Example.class /tmp
WORKDIR /tmp
ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS Example"]

这样再执行docker run -it -e JAVA_OPTS="-Xmx1g" --memory 2g javatest，JVM就会应用你设置的1GB堆内存。

2. 其他可用于设置JVM参数的环境变量

• JAVA_TOOL_OPTIONS：JVM官方支持的环境变量，无论启动命令如何配置，JVM都会自动读取该变量中的参数（优先级低于直接在命令行指定的参数）。适合无法修改镜像ENTRYPOINT的场景，示例：

  docker run -it -e JAVA_TOOL_OPTIONS="-Xmx1g" --memory 2g javatest
  

• JVM_OPTS：很多Java镜像会默认支持这个变量，作用和JAVA_OPTS一致，用于传递JVM启动参数。
• _JAVA_OPTIONS：属于旧版JDK兼容的环境变量，功能和JAVA_TOOL_OPTIONS类似，现在大部分场景已被前者替代，但部分旧环境仍可使用。

注意事项 #

如果同时设置容器--memory和JVM-Xmx，要确保-Xmx的值小于容器内存（需预留出JVM非堆内存、系统进程等占用的空间），否则容器可能因内存超限被Docker强制终止。

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