Dockerfile构建报错：stage循环依赖，如何排查与解决？

报错根本原因 #

你的Dockerfile多阶段构建中出现了自引用循环：

FROM ikerib/aurki2de:latest as aurkibide
WORKDIR /usr/src/app
COPY --from=aurkibide /usr/src/app/public .

这段代码定义了名为aurkibide的构建阶段，紧接着又用COPY --from=aurkibide试图从这个阶段复制文件——相当于这个阶段要依赖自身才能完成构建，Docker无法处理这种逻辑闭环，因此抛出循环依赖错误。

你的真实需求是让Nginx容器获取Symfony应用的public目录，不该在Nginx的Dockerfile里定义同名的构建阶段，而是直接从已有的PHP应用镜像复制内容。

循环引用排查与调试方法 #

• 逐行核对阶段引用：遍历Dockerfile中所有FROM ... as <stage>和COPY --from=<stage>指令，确认每个COPY引用的阶段要么是当前Dockerfile中已提前定义的独立阶段，要么是外部镜像名，避免出现阶段自引用或交叉引用
• 分步构建测试：简化Dockerfile，先只保留基础镜像和配置文件复制指令，构建验证正常后，再逐步添加COPY等指令，每添加一步就执行docker build .，定位触发循环的具体指令
• 查看详细构建日志：执行docker build --progress=plain .，获取更详细的构建步骤输出，能精准看到Docker解析阶段依赖时的错误节点

修正后的Dockerfile示例 #

直接从你的PHP应用镜像ikerib/aurki2de:latest复制public目录到Nginx的静态文件目录（通常为/usr/share/nginx/html），同时保留Nginx配置文件的复制：

FROM nginx:1.21.6-alpine

# 复制自定义Nginx配置
ADD ./docker/nginx/default.conf /etc/nginx/conf.d/default.conf
ADD ./docker/nginx/nginx.conf /etc/nginx/nginx.conf

# 从PHP应用镜像复制Symfony的public目录到Nginx根目录
COPY --from=ikerib/aurki2de:latest /usr/src/app/public /usr/share/nginx/html

注意：确保Nginx配置文件default.conf中的root指令指向上述复制路径（比如root /usr/share/nginx/html;），否则会出现404错误。

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