如何将本地GOPATH/pkg/mod共享给Docker多阶段构建的builder阶段

错误原因说明 #

你之前执行COPY操作失败的核心原因是：Docker构建时默认仅将执行docker build命令所在的目录作为构建上下文，你本地的$GOPATH路径不在该上下文范围内，因此Docker无法读取到对应目录完成复制操作。

方案1：Docker层缓存优化（通用可共享方案） #

该方案无需依赖本地环境配置，所有人拿到Dockerfile都可以享受到构建缓存，仅在go.mod/go.sum变更时才会重新下载依赖。
修改后的Dockerfile如下：

FROM golang:1.17 as builder
# 优先复制依赖声明文件
COPY go.mod go.sum ./
# 提前下载依赖，只要依赖文件不变，该层会被Docker永久缓存
RUN go mod download
# 再复制完整项目代码
COPY . . 
RUN CGO_ENABLED=0 GOOS=linux go build -o /bin/amazingo cmd/main.go 

FROM alpine:latest
COPY --from=builder /bin/amazingo /amazingo
ENTRYPOINT ["/amazingo"]

无需修改构建命令，直接执行docker build -t amazingo:0.0.1 .即可，第二次构建开始就会复用依赖层缓存。

方案2：挂载本地依赖缓存（本地高频构建加速方案） #

如果要直接复用本地已经下载到$GOPATH/pkg/mod的依赖，可以使用Docker BuildKit的绑定挂载功能，完全避免重复下载依赖。

操作步骤 #

1. 确保本地Docker版本 >= 18.09，支持BuildKit特性
2. 执行如下构建命令即可：

DOCKER_BUILDKIT=1 docker build \
  --mount type=bind,source=$GOPATH/pkg/mod,target=/go/pkg/mod \
  -t amazingo:0.0.1 .

该方案不会修改Dockerfile内容，也不会把本地依赖文件打入最终镜像，仅在构建阶段临时挂载本地缓存目录。

注意 #

该方案仅适合本地自行构建使用，共享给其他使用者的Dockerfile不要添加绑定挂载相关的硬编码配置，避免其他环境构建失败。

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