Dockerfile中SHELL指令前置命令失效问题排查

我有如下script.sh文件：

MYVAR=world

同时编写了如下Dockerfile：

FROM redhat/ubi8
COPY script.sh /script.sh

# 加载脚本并输出，预期结果：hello world
RUN source /script.sh && echo hello $MYVAR

# 不加载脚本直接输出，预期结果：hello
RUN echo hello $MYVAR

# 修改SHELL后输出，预期结果：hello world
SHELL ["/bin/bash", "-c", "'source /script.sh'", "&&"]
RUN echo hello $MYVAR

最后一组SHELL与RUN命令未达预期。我期望最终RUN命令执行/bin/bash -c 'source /script.sh' && echo hello $MYVAR，通过docker build . --preview plain验证确实生成了该命令，且在本地命令行执行正常，但构建时出现如下错误：

#9 [5/5] RUN echo hello $MYVAR
#9 0.194 &&: source /script.sh: No such file or directory
#9 ERROR: process "/bin/bash -c 'source /script.sh' && echo hello $MYVAR" did not complete successfully: exit code: 127
------
 > [5/5] RUN echo hello $MYVAR:
0.194 &&: source /script.sh: No such file or directory
------
Dockerfile:12
--------------------
 10 |     SHELL ["/bin/bash", "-c", "'source /script.sh'", "&&"]
 11 |
 12 | >>> RUN echo hello $MYVAR
 13 |
--------------------
ERROR: failed to solve: process "/bin/bash -c 'source /script.sh' && echo hello $MYVAR" did not complete successfully: exit code: 127

我尝试了多种SHELL指令写法，均未解决问题，多数返回不同退出码，其中一种无报错但输出为空：

• SHELL ["/bin/bash", "-c", "source /script.sh", "&&"]
• SHELL ["/bin/bash", "-c", "\"source /script.sh\"", "&&"]
• SHELL ["/bin/bash", "-c", "source /script.sh &&"]
• SHELL ["/bin/bash", "-c", "'source /script.sh' &&"]
• SHELL ["/bin/bash", "-c", "\"source /script.sh" &&"]

核心原因 #

Docker的SHELL指令用于定义后续RUN/CMD/ENTRYPOINT执行命令时的shell程序及其默认参数，而非拼接命令前缀。你误解了它的工作逻辑：

• 设置SHELL ["/bin/bash", "-c", "'source /script.sh'", "&&"]后，Docker会将RUN的内容直接拼接到这些参数后，最终执行的命令结构为：

  /bin/bash -c 'source /script.sh' && echo hello $MYVAR
  

  但/bin/bash -c仅接受单个参数作为要执行的命令字符串，后面的&& echo hello $MYVAR会被当作bash的独立参数，而非命令的一部分。bash会把&&视为要执行的命令，自然找不到对应程序，因此报错。

正确实现方式 #

若要让每个RUN自动加载脚本，有两种可靠方案：

方案1：利用bash启动脚本

借助bash的启动特性，让bash每次启动时自动加载目标脚本：

FROM redhat/ubi8
COPY script.sh /script.sh
# 将加载命令写入bash全局启动脚本
RUN echo "source /script.sh" > /etc/profile.d/myenv.sh

# 后续RUN自动加载脚本
RUN echo hello $MYVAR  # 输出hello world

方案2：统一命令前缀

直接在需要加载脚本的RUN前添加source /script.sh &&，若嫌重复可通过注释或变量统一管理：

FROM redhat/ubi8
COPY script.sh /script.sh

RUN echo hello $MYVAR  # 输出hello
RUN source /script.sh && echo hello $MYVAR  # 输出hello world

错误写法的本质

所有尝试的SHELL写法都错误地将source命令拆分为bash的独立参数，而非将完整命令逻辑放入-c的参数中。SHELL的正确用法是定义shell的默认执行方式（比如SHELL ["/bin/bash", "-c"]，这也是ubi8的默认值），而非用来拼接前置命令。

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