CodeBuild的buildspec.yml中Python subprocess执行异常问题

核心原因 #

CodeBuild执行Python脚本时，subprocess.run默认继承的环境变量PATH和buildspec直接执行命令时的PATH不一致，导致找不到docker命令的路径。buildspec的shell环境会加载完整的系统PATH，但Python脚本通过subprocess.run调用时，默认的环境变量可能被限制，未包含docker的安装路径。

具体排查与解决步骤 #

1. 确认docker在CodeBuild环境中的绝对路径 #

先在buildspec.yml里添加命令打印docker的路径：

phases:
  build:
    commands:
      - which docker

运行后会得到类似/usr/bin/docker的路径，记录该路径。

2. 方法一：在subprocess.run中指定docker绝对路径 #

修改脚本里的调用命令，直接使用docker的绝对路径：

import subprocess
subprocess.run(["/usr/bin/docker", "pull", "your-ecr-image:tag"])

3. 方法二：给subprocess传递完整环境变量 #

调用subprocess时显式传入当前shell的环境变量，确保PATH包含docker路径：

import subprocess
import os

# 继承完整系统环境变量
subprocess.run(["docker", "pull", "your-ecr-image:tag"], env=os.environ)

如果需要自定义PATH，也可以手动添加：

import subprocess
import os

new_env = os.environ.copy()
# 将docker所在路径添加到PATH最前方
new_env["PATH"] = "/usr/bin:" + new_env["PATH"]
subprocess.run(["docker", "pull", "your-ecr-image:tag"], env=new_env)

4. 额外检查：运行用户权限 #

确认CodeBuild服务角色有执行docker的权限（既然buildspec直接能跑，此问题概率低），同时检查脚本是否切换了用户（比如sudo），导致PATH环境变量被重置。

验证方法 #

在脚本里添加打印当前PATH的代码，查看是否缺失docker路径：

import os
print("Current PATH:", os.environ.get("PATH"))

通过CodeBuild的构建日志就能直观看到PATH的配置情况。

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