在 Dockerfile 中，ENTRYPOINT 的两种写法（exec 格式和 shell 格式）在环境变量展开方面有重要区别，尤其是对于 $JAVA_OPTS 这样的动态变量。以下是详细对比分析：

1. Exec 格式（推荐）

ENTRYPOINT ["java", "$JAVA_OPTS", "-jar", "/app.jar"]

特点：

• 不展开环境变量：
  Exec 格式会直接按字面值传递 "$JAVA_OPTS"，不会解析为环境变量的值。此时 $JAVA_OPTS 会被当作一个普通字符串（即运行命令时会尝试传递 "$JAVA_OPTS" 而不是变量的实际内容）。

修正方法：

如果需要展开环境变量，需通过 Shell 包装：

ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar /app.jar"]

这样 Shell 会解析 $JAVA_OPTS。

2. Shell 格式

ENTRYPOINT java $JAVA_OPTS -jar /app.jar

特点：

• 自动展开环境变量：
  Shell 格式会通过 /bin/sh -c 执行命令，因此 $JAVA_OPTS 会被替换为环境变量的值。例如，若 JAVA_OPTS="-Xms512m -Xmx1G"，实际执行的命令会是：

java -Xms512m -Xmx1G -jar /app.jar

注意事项：

• 会以 Shell 子进程运行，因此 java 进程的 PID 不是 1，可能影响信号传递（如 SIGTERM）。
• 变量注入需在容器运行时通过 -e 或环境文件传递。

关键对比项

推荐解决方案

1. 使用 Shell 格式（简单场景）

ENTRYPOINT java $JAVA_OPTS -jar /app.jar

适用场景：
需要动态变量展开，且不关心 PID 1 或信号处理。

2. 使用 Exec 格式 + 环境变量文件（生产推荐）

ENV JAVA_OPTS=""
ENTRYPOINT ["sh", "-c", "java ${JAVA_OPTS} -jar /app.jar"]

优势：

• 显式声明依赖的环境变量。
• 允许通过 docker run -e JAVA_OPTS="..." 动态覆盖。

3. 直接拆分参数（最佳实践）

如果 JAVA_OPTS 是固定值，建议直接拆分为多个 ARG/ENV：

ENV JVM_XMS="-Xms512m"
ENV JVM_XMX="-Xmx1G"
ENTRYPOINT ["java", "${JVM_XMS}", "${JVM_XMX}", "-jar", "/app.jar"]

优势：

• 避免 Shell 解析，提升安全性。
• 保持 PID 1 直接为 Java 进程。

总结

• $JAVA_OPTS 能否展开：
  Shell 格式或 Exec 格式中通过 sh -c 可以展开，纯 Exec 格式不能。
• 选择依据：

• 需要变量动态替换 → 使用 Shell 格式或 Exec + Shell 包装。
• 需要 PID 1 和信号安全 → 使用 Exec 格式并拆分参数。

建议通过 docker inspect 验证最终生成的命令是否符合预期。