Docker容器中CMD启动的脚本缺失环境变量问题排查与解决

问题原因 #

核心问题是CMD指令的执行模式导致环境变量未加载：

• 当使用CMD "./script.sh"写法时，Docker会以exec模式直接执行脚本文件，而非通过shell进程启动。这种模式仅传递最基础的几个环境变量（PWD、SHLVL等），不会加载ENV指令设置的变量，也不会执行shell初始化脚本（如/etc/profile、~/.bashrc）读取标准系统变量。
• 而docker exec进入容器时，默认启动交互式shell，该shell会加载完整环境配置，因此能看到所有变量。

解决方法 #

有三种可靠方式让脚本在完整环境中运行：

1. 改用Shell格式的CMD（推荐） #

去掉CMD里的引号，直接写脚本路径：

CMD ./script.sh

这种写法下，Docker会自动用/bin/sh -c "./script.sh"执行，shell进程会加载所有ENV设置的变量和标准系统变量。

2. 明确指定用Shell执行脚本（Exec格式） #

若需用Exec数组格式，直接调用bash运行脚本：

CMD ["/bin/bash", "./script.sh"]

bash启动时会自动加载环境变量配置，确保脚本能获取所有变量。

3. 修改脚本的Shebang行 #

在脚本开头的Shebang里添加-l参数（登录shell模式），强制bash加载系统环境配置：

#!/bin/bash -l
echo env... 
env 
echo waiting... 
tail -f /dev/null

这样即使Docker用exec模式直接执行脚本，bash也会以登录shell启动，加载完整环境变量。

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