在 docker 中运行 java 应用需正确传递 jvm 参数：推荐显式使用 entrypoint 调用 java 命令并内联参数；可通过 java_tool_options 环境变量动态配置；须配合 -xx:+usecontainersupport 与 -xx:maxrampercentage 适配容器内存限制；gc 日志应输出到 stdout，jfr 文件需挂载卷持久化。
在 Docker 中运行 Java 应用时，JVM 参数不能像本地那样直接写在 java 命令里就完事——容器启动方式、镜像基础、ENTRYPOINT 与 CMD 的协作关系，都会影响参数是否真正生效。关键在于：把 JVM 参数正确传递给 java 进程，且不被 Docker 启动逻辑覆盖。
使用官方 OpenJDK 镜像并显式调用 java 命令
推荐基于 openjdk:17-jre-slim（或你所需的 JDK 版本）构建镜像，避免使用某些精简版可能缺失 jvm.dll 或工具链。在 Dockerfile 中不要依赖隐式 java 启动，而是明确写出 java 命令，并将 JVM 参数放在 java 和 -jar 之间：
-
✅ 正确写法（JVM 参数生效）：
ENTRYPOINT ["java", "-Xms512m", "-Xmx1g", "-XX:+UseG1GC", "-jar", "/app.jar"] -
❌ 错误写法（参数被忽略）：
ENTRYPOINT ["java", "-jar", "/app.jar"]<br>CMD ["-Xmx1g"]
—— CMD 不会合并到 ENTRYPOINT 的参数列表中，只会覆盖整个命令
通过环境变量动态传入 JVM 参数（适合多环境部署）
若需在不同环境（如测试/生产）灵活调整堆大小或 GC 策略，可借助 JAVA_TOOL_OPTIONS 环境变量。它会被 JVM 自动读取，无需修改启动命令：
- 在
Dockerfile中设置默认值：ENV JAVA_TOOL_OPTIONS="-Xms256m -Xmx512m -XX:+UseZGC" - 运行时覆盖：
docker run -e JAVA_TOOL_OPTIONS="-Xms1g -Xmx2g -XX:+UseG1GC" my-java-app -
注意：
JAVA_TOOL_OPTIONS对所有 JVM 进程生效（包括 javac、jstack 等），生产环境慎用复杂参数；不支持-D系统属性以外的某些高级选项（如-XX:StartFlightRecording需显式声明）
避免常见陷阱：容器内存限制与 JVM 自动配置冲突
Docker 的 --memory 限制（如 --memory=1g）不会自动同步给 JVM。JDK 8u191+ 和 JDK 10+ 支持 -XX:+UseContainerSupport（默认开启），但必须配合 -XX:MaxRAMPercentage 才能按容器限制动态设堆：
- 推荐组合（JDK 11+）：
java -XX:+UseContainerSupport -XX:MaxRAMPercentage=75.0 -jar app.jar
表示最多使用容器内存上限的 75% - 旧版本 JDK（如 8u131~191）需显式关闭自动检测：
-XX:-UseCGroupMemoryLimitForHeap，再手动用-Xmx - 验证是否生效：进入容器执行
java -XX:+PrintFlagsFinal -version | grep -E "MaxHeapSize|MaxRAM"
日志与调试支持：确保 JVM 输出不被容器截断
JVM 日志（GC、JFR、线程 dump）默认输出到 stdout/stderr，在 Docker 中应保持可见并可收集：
- GC 日志建议重定向到 stdout，便于日志系统采集：
-Xlog:gc*:stdout:time,tags,level（JDK 11+） - 启用 JFR（Java Flight Recorder）时，用
-XX:StartFlightRecording=disk=true,settings=profile,duration=60s,filename=/tmp/recording.jfr，并挂载/tmp卷以便导出 - 避免将日志写入不可见路径（如
/var/log/app/）却不做卷映射，否则容器重启后日志丢失
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
