Docker镜像构建报错：无法用文件替换目录问题求助

问题分析 #

报错触发于COPY --from=builder / /命令，核心原因是Docker 23.x版本对文件/目录覆盖的校验逻辑更严格：

• builder阶段基于ubuntu:focal，其/bin是实际目录
• 最终阶段基于python:3.8.3-slim（Debian Slim镜像），其/bin是指向/usr/bin的符号链接
• 新版本Docker禁止用目录替换符号链接（符号链接属于文件类型），而旧版本（20.10.x）未做严格校验，因此本地能正常构建。

解决思路 #

1. 避免全量复制根目录（推荐） #

全量复制/会引入大量冗余文件，还容易触发跨镜像的结构冲突。只复制builder阶段实际需要的内容，比如如果builder阶段安装了特定系统依赖，明确复制对应路径：

# 替换原来的COPY --from=builder / /
COPY --from=builder /usr/lib /usr/lib
COPY --from=builder /usr/bin /usr/bin
# 根据实际需要添加其他必要路径

2. 统一基础镜像 #

将最终阶段的基础镜像改为与builder一致的ubuntu:focal，消除目录结构差异：

# 替换原来的FROM python:3.8.3-slim
FROM ubuntu:focal

# 在Ubuntu基础上安装Python 3.8.3
RUN apt-get update && apt-get install -y python3.8 python3-pip python3.8-dev
# 后续步骤保持不变

3. 先删除冲突的符号链接（临时方案） #

如果必须全量复制，在COPY前先删除目标中的/bin符号链接：

# 在COPY --from=builder / /之前添加
RUN rm -f /bin
COPY --from=builder / /

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