CodeBuild构建阶段Docker build失败问题排查问询

从你提供的日志和配置来看，核心问题非常明确：你的CodeBuild容器里的Docker守护进程（daemon）根本没运行，导致docker build命令无法连接到本地套接字。虽然你已经搞定了ECR的权限配置，但这和Docker daemon是否能正常启动是完全独立的两个问题，权限问题只会在镜像推送/拉取时触发，而你现在卡在了最基础的构建环节。

问题原因拆解 #

亚马逊托管的Ubuntu标准镜像，默认情况下是没有启动Docker daemon的，也没有配置Docker-in-Docker（DinD）所需的特权环境。CodeBuild的构建容器本质上也是一个Docker容器，要在里面运行Docker daemon，必须满足两个条件：

• 容器以**特权模式（Privileged Mode）**运行
• 镜像本身预装了Docker，并且能自动（或手动）启动daemon服务

具体排查&解决步骤 #

我给你整理了几个优先级从高到低的解决办法：

1. 检查CodeBuild项目的特权模式是否开启
   这是最常见的疏漏：进入你的CodeBuild项目配置 → 找到「环境」板块 → 确认「特权」选项已经勾选「启用」。Docker daemon需要特权权限才能在容器内创建网络、挂载存储等，没开这个的话肯定启动不了。

2. 更换支持Docker的亚马逊托管镜像版本
   早期的Ubuntu Standard镜像（比如standard:1.0）没有预装Docker环境，建议直接切换到aws/codebuild/standard:5.0及以上版本。这些新版本的标准镜像默认集成了Docker，并且会自动处理daemon的启动，不用你手动加启动命令。

3. 手动在buildspec.yml中添加启动Docker daemon的命令
   如果你暂时不想换镜像版本，可以在pre_build阶段添加启动命令，确保daemon在构建前运行：

   version: 0.2
   phases:
     pre_build:
       commands:
         - echo Logging in to Amazon ECR...
         - $(aws ecr get-login --no-include-email --region eu-west-1)
         - echo Starting Docker daemon...
         - sudo service docker start
         - sudo docker info  # 这一步可以验证daemon是否启动成功
     build:
       commands:
         - echo Building the Docker image...
         - docker build -t maxmind:latest .
         - docker tag maxmind:latest 381475286792.dkr.ecr.eu-west-1.amazonaws.com/maxmind:latest
     post_build:
       commands:
         - echo Build completed on `date`
         - echo Pushing the Docker image...
         - docker push 381475286792.dkr.ecr.eu-west-1.amazonaws.com/maxmind:latest
   

   注意：如果你的Ubuntu版本用service命令无效，可以换成sudo systemctl start docker试试。

4. 验证Docker环境是否正常
   可以在pre_build阶段先执行docker info或docker version命令，如果这些命令能返回正常输出，说明daemon已经启动，后续的docker build和docker push就不会再报连接错误了。

额外提醒 #

你之前附加的AmazonEC2ContainerRegistryPowerUser策略是没问题的，这个权限足够完成ECR的登录、推送和拉取操作，所以不用在权限上浪费时间，把重点放在Docker daemon的启动配置上就行。

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