Shell脚本转Dockerfile部署Java应用报setenv无效参数错误排查

容器启动报setenv: invalid argument是Dockerfile写法错误导致的，共有3处核心问题：

1. ENV指令语法错误
   你写的ENV $CLASSPATH=$APPLICATION_DIR/classes:$CLASSPATH在变量名前多加了$符号。Docker的ENV指令定义变量时，变量名前不需要加$取值符。这行执行时CLASSPATH初始值为空，相当于定义了一个变量名为空的环境变量，容器启动加载环境变量时就会触发参数非法错误。
2. RUN指令的环境变量不持久
   Dockerfile中每个RUN指令都会启动独立的Shell子进程，进程内export的环境变量仅在当前RUN执行阶段生效，进程退出后变量就会被销毁。你之前写的for循环拼接CLASSPATH的RUN指令，执行完后拼接的类路径值就丢了，后续指令和容器运行时根本读不到。
3. ENTRYPOINT写法错误
   你用的方括号包裹的exec格式ENTRYPOINT不会启动Shell做变量替换，写在里面的${APPLICATION_DIR}会原封不动作为字符串传给JVM，不会被解析成实际路径。另外你把3个独立的JVM参数拼成了同一个字符串，JVM无法正确识别拆分参数。

Java 6及以上版本原生支持类路径通配符，不需要写循环遍历lib目录下的jar包，用lib/*就可以自动加载目录下所有jar包，完全匹配你原来Shell脚本的逻辑，修正后的Dockerfile如下：

FROM openjdk:11

# 校验Java环境
RUN java -version && javac -version

# 设置应用工作目录
WORKDIR /usr/src/app

# 拷贝应用文件到镜像
COPY . .

# 配置固定环境变量
ENV APPLICATION_DIR=/usr/src/app
# 通配符自动加载lib下所有jar，配置类路径
ENV CLASSPATH=${APPLICATION_DIR}/classes:${APPLICATION_DIR}/lib/*

# 每个JVM参数单独作为数组项，路径直接写固定值避免变量解析问题
ENTRYPOINT [\
  "java", \
  "-Xverify:none", \
  "-Xmx2048m", \
  "-Djava.awt.headless=true", \
  "-DFI_IS_CONFIGSER=N", \
  "-DFICLIENT_APP_PATH=/usr/src/app", \
  "-DFI_APP_NAME=FIONLINE", \
  "-DFI_BASE_INSTANCE_ID=1", \
  "-DPRODUCT_BOOTSTRAP_FILE=/usr/src/app/data/BootstrapFile.properties", \
  "-DFEBA_SYS_PATH=/usr/src/app/data" \
]

如果你后续需要动态挂载外部jar包到lib目录，需要启动时实时计算CLASSPATH，可以用shell格式的ENTRYPOINT，不需要单独写启动脚本，直接在ENTRYPOINT里完成拼接即可：

# 替换上述Dockerfile中的ENTRYPOINT部分
ENTRYPOINT export CLASSPATH="classes:$(printf '%s:' lib/*.jar)" && \
  java -Xverify:none -Xmx2048m -Djava.awt.headless=true \
  -DFI_IS_CONFIGSER=N \
  -DFICLIENT_APP_PATH=${APPLICATION_DIR} \
  -DFI_APP_NAME=FIONLINE \
  -DFI_BASE_INSTANCE_ID=1 \
  -DPRODUCT_BOOTSTRAP_FILE=${APPLICATION_DIR}/data/BootstrapFile.properties \
  -DFEBA_SYS_PATH=${APPLICATION_DIR}/data

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