Symfony项目Docker化失败：symfony-docker构建容器镜像报错

先获取详细错误信息 #

当前错误仅提示exit code 1，无法定位具体原因，先执行带详细输出的构建命令：

docker compose build --no-cache --pull --progress=plain

查看完整日志里的具体报错内容（比如网络超时、版本不兼容提示等）。

常见原因及解决办法 #

1. 网络无法拉取Go依赖/插件（最常见） #

如果日志里有类似timeout、unable to fetch的提示，是网络问题导致无法拉取Mercure/Vulcain的Go模块或插件代码：

• 临时解决：构建时通过build-arg指定Go代理：

  docker compose build --no-cache --pull --build-arg GOPROXY=https://goproxy.cn
  

• 永久解决：修改Dockerfile，在xcaddy build命令前添加环境变量：

  ENV GOPROXY=https://goproxy.cn,direct
  

2. Caddy与插件版本不兼容 #

如果日志里有版本冲突提示，比如invalid version、module does not match：

• 更新symfony-docker骨架到最新版本（备份现有项目文件后）：

  git clone https://github.com/dunglas/symfony-docker.git .
  

• 或者在Dockerfile的xcaddy命令中指定兼容的插件版本（替换为对应版本号，可查项目GitHub仓库的tags）：

  xcaddy build \
    --with github.com/dunglas/mercure@v0.13.0 \
    --with github.com/dunglas/mercure/caddy@v0.13.0 \
    --with github.com/dunglas/vulcain@v0.8.0 \
    --with github.com/dunglas/vulcain/caddy@v0.8.0
  

3. Docker构建缓存残留问题 #

清理Docker的构建缓存后重新构建：

docker builder prune -af
docker compose build --no-cache --pull

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