Docker CMD使用方括号形式时环境变量无法解析的原因咨询

你碰到的问题本质是Docker的exec格式CMD不会触发shell的变量替换逻辑，具体原因和解决办法如下：

两种CMD格式的核心差异 #

• exec格式（方括号形式）：CMD ["/opt/apps/${COMPONENT_NAME}", "--seed"]
  Docker会直接通过系统调用执行指定的命令和参数，完全不经过shell。这意味着${COMPONENT_NAME}会被当作字面量字符串处理，而不是环境变量，所以容器会去查找路径为/opt/apps/${COMPONENT_NAME}的文件，自然找不到。
• shell格式（无方括号形式）：CMD /opt/apps/${COMPONENT_NAME} --seed
  Docker会自动把这条命令包装成/bin/sh -c "/opt/apps/${COMPONENT_NAME} --seed"执行。此时shell会先解析命令中的环境变量，把${COMPONENT_NAME}替换成实际值，再运行目标命令，所以能正常工作。

用exec格式实现变量解析的两种方案 #

如果必须使用exec格式（比如需要传递信号给进程），可以通过以下方式解决：

1. 显式调用shell处理变量
   手动把命令交给shell解析，写法如下：

   ARG COMPONENT
   ENV COMPONENT_NAME=${COMPONENT}
   CMD ["/bin/sh", "-c", "/opt/apps/${COMPONENT_NAME} --seed"]
   

   这种方式和shell格式的底层逻辑一致，都是让shell先完成变量替换再执行命令。
2. 构建阶段固化变量到脚本
   如果COMPONENT的值在构建镜像时就已经确定，不需要在运行时修改，可以直接在构建阶段把变量写入可执行脚本：

   ARG COMPONENT
   RUN echo "#!/bin/sh" > /run-app.sh && \
       echo "/opt/apps/${COMPONENT} --seed" >> /run-app.sh && \
       chmod +x /run-app.sh
   CMD ["/run-app.sh"]
   

   运行容器时直接执行脚本，脚本里的路径已经是替换后的实际值，无需再解析环境变量。

（注：你的Dockerfile里有个笔误：ENV EOMPONENT_NAME=${COMPONENT}应该是ENV COMPONENT_NAME=${COMPONENT}，修正后能避免额外的变量错误）

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