Docker多阶段构建COPY命令出现file does not exist错误该如何排查？

错误原因 #

报错核心为第二阶段复制第一阶段产物时路径不匹配：

• 官方golang镜像默认工作目录为/go，第一阶段执行go build dispatcher.go生成的可执行文件路径为/go/dispatcher，而非根目录下的/dispatcher
• 第二阶段COPY --from=0 dispatcher .指令默认从第一阶段的根目录查找文件，无法匹配到实际生成的可执行文件路径

修复方案 #

以下两种方案二选一即可：

方案1：直接指定第一阶段产物的绝对路径 #

仅修改第二阶段COPY指令即可：

COPY --from=0 /go/dispatcher .

方案2：显式声明工作目录，避免路径依赖（更推荐） #

完整修改后的Dockerfile如下，可降低不同基础镜像默认路径差异带来的问题：

FROM golang
WORKDIR /app
COPY ["dispatcher.go", "dispatcher.go"]
RUN go build dispatcher.go

FROM scratch
COPY --from=0 /app/dispatcher .

如果修改后仍存在问题，可在第一阶段go build指令后添加RUN pwd && ls，构建时查看第一阶段的工作目录和生成文件列表，进一步确认路径。

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