Dockerfile传递Java启动参数时环境变量未解析异常排查

所有异常都来自两个核心认知错误：

1. Dockerfile中使用方括号的exec格式指令（ENTRYPOINT/CMD/RUN）不会自动执行Shell变量替换，直接将数组内的字符串原样传给执行程序，这就是拿到"$my_env_var"字面字符串的核心原因。
2. 对Dockerfile指令语法、sh -c的执行规则存在多处写法错误，逐一对应如下：

• 初始ENV写法语法错误：ENV my_env_var = "9100" 中等号两侧不能加空格，该写法实际会给my_env_var赋值为= "9100"，不符合预期。ENV正确语法为ENV 键=值（等号无空格）或ENV 键 值。
• sh -c用法错误：sh -c只会将紧随其后的第一个字符串作为待执行的Shell脚本解析，后续传入的所有参数会被当作Shell脚本的位置参数（$0、$1...），不会自动拼接到执行命令中。之前写的["sh","-c","java","-jar","xxx.jar","$port"]实际仅执行了无参数的java命令，因此触发Java用法提示。
• Shell格式CMD写法错误：给整段启动命令加了双引号，Docker会将引号内的完整字符串识别为单个可执行文件名查找，自然会报“命令不存在”；另外指令名虽然大小写不敏感，但标准写法为全大写CMD。
• exec格式RUN的变量问题：和exec格式ENTRYPOINT逻辑一致，该格式不会解析$port变量，构建日志中显示的1414是构建层记录的ARG参数值，并非实际传入Java程序的参数，因此依然会抛出数字格式异常。
• ARG方案无效的原因：ARG是构建阶段生效的变量，镜像构建完成、容器启动后ARG值不会保留，除非显式将ARG值赋值给ENV。

方案1：使用Shell格式指令（写法最简单） #

Shell格式的ENTRYPOINT/CMD会自动通过/bin/sh -c执行，原生支持变量替换，不需要额外处理：

FROM openjdk:8-jre
COPY target/ReadingNode-1.0-SNAPSHOT.jar ReadingNode-1.0-SNAPSHOT.jar
# 配置默认端口，等号两侧无空格
ENV SERVICE_PORT=9100
# Shell格式ENTRYPOINT，不要加方括号、不要给整段命令加引号
ENTRYPOINT java -jar ReadingNode-1.0-SNAPSHOT.jar $SERVICE_PORT

启动容器时可直接通过-e覆盖端口：

docker run -p 9140:9140 -e SERVICE_PORT=9140 readingnode

方案2：使用exec格式（适配信号传递场景） #

如果需要让Java进程直接接收docker stop发送的SIGTERM信号（避免sh进程吞信号导致优雅失效），可以用正确的sh -c写法，将完整启动命令全部放到sh -c的脚本字符串参数中：

FROM openjdk:8-jre
COPY target/ReadingNode-1.0-SNAPSHOT.jar ReadingNode-1.0-SNAPSHOT.jar
ENV SERVICE_PORT=9100
ENTRYPOINT ["sh", "-c", "java -jar ReadingNode-1.0-SNAPSHOT.jar $SERVICE_PORT"]

构建时设置默认端口的补充写法 #

如果需要在镜像构建阶段指定默认端口，可以用ARG+ENV的组合写法：

FROM openjdk:8-jre
COPY target/ReadingNode-1.0-SNAPSHOT.jar ReadingNode-1.0-SNAPSHOT.jar
# 定义构建参数，设置默认值
ARG DEFAULT_PORT=9100
# 将构建参数赋值给运行时生效的ENV
ENV SERVICE_PORT=${DEFAULT_PORT}
ENTRYPOINT java -jar ReadingNode-1.0-SNAPSHOT.jar $SERVICE_PORT

构建时可通过--build-arg修改默认端口：

docker build --build-arg DEFAULT_PORT=9101 -t readingnode .

内容的提问来源于stack exchange，提问作者أكثم الحميدات