如何查看Dockerfile执行bash脚本的输出以排查错误？

问题场景 #

Docker构建时执行bash脚本，仅返回模糊的退出码（比如exit code: 127），无法直接定位脚本内部的具体错误和出错代码行，逐行注释排查效率极低，需要更高效的排查方式。

推荐排查方法 #

• 开启脚本调试模式
  这是最直接的定位方式，能让脚本输出每一步执行的命令和结果：

  • 方法1：在脚本开头添加set -x，脚本执行时会打印每一条执行的命令及参数，出错时能直接看到对应行。若不需要全局调试，可在目标代码段前后分别加set -x（开启）和set +x（关闭）。
  • 方法2：无需修改脚本，直接在Dockerfile的RUN命令里指定调试模式执行：

    RUN bash -x test.sh
    

• 保留完整错误输出
  避免脚本里出现command > /dev/null 2>&1这类屏蔽输出的写法。若Docker构建时未显示错误详情，可在RUN命令里显式合并标准错误与标准输出：

  RUN test.sh 2>&1
  

  这样脚本的错误信息会被完整打印，方便定位问题。

• 进入容器手动调试
  若出错步骤之前的镜像已生成，可直接运行该镜像进入容器，手动执行脚本排查：

  1. 通过docker images找到构建过程中生成的中间镜像ID
  2. 启动交互式容器：

     docker run --rm -it <中间镜像ID> bash
     

  3. 在容器内手动执行脚本，甚至用bash -x test.sh调试，还能直接检查容器内环境（如依赖是否安装、文件路径是否正确）。

• 检查脚本shebang
  退出码127常因脚本解释器错误或找不到导致：

  • 确保脚本开头的shebang匹配解释器，比如用bash语法的脚本要写#!/bin/bash，而非#!/bin/sh（Docker默认的sh可能是dash这类轻量shell，不支持bash部分语法）。
  • 若shebang正确仍出错，可在RUN命令里显式指定bash执行：RUN bash test.sh。

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