使用多阶段构建Docker镜像失败：循环依赖问题排查

问题原因 #

你的Dockerfile存在两个关键问题：

1. 语法错误触发误判：builder阶段最后一个RUN命令末尾多余了&& \，导致Docker构建引擎解析异常，误报为循环依赖错误。
2. COPY路径不符合预期：原COPY指令会将.bin目录下的内容直接复制到/root目录，而不是保留.bin目录结构。

修复步骤 #

1. 修复RUN命令语法错误 #

找到builder阶段最后一个RUN命令，去掉末尾多余的&& \：

# 修改后
RUN apt-get clean && \
    apt-get autoclean && \
    apt-get autoremove -y && \
    rm -rf /var/lib/cache/* && \
    rm -rf /var/lib/log/*

2. 调整COPY指令路径 #

将原COPY指令修改为以下其中一种，确保完整复制.bin目录：

# 方式1：直接指定目标目录
COPY --from=builder ${BIN_DIR} ${BIN_DIR}

# 方式2：基于HOME目录复制
COPY --from=builder ${HOME}/.bin ${HOME}/

3. （可选）使用固定标签的基础镜像 #

将ubuntu:latest替换为具体版本（如ubuntu:22.04），避免因latest标签更新导致的构建不稳定：

FROM ubuntu:22.04 AS builder
# ...
FROM ubuntu:22.04
# ...

验证 #

修改完成后，重新执行构建命令：

docker-compose --env-file .env.mac build dev_mac

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