如何避免docker build过程中重复下载已复制的Go vendor依赖

你之前的配置不生效有两个核心原因：

1. 原Dockerfile中COPY . .之后执行RUN go mod vendor，如果本地已有的vendor目录和go.mod/go.sum校验不一致，该命令会直接覆盖本地复制进去的vendor目录，触发重新拉取
2. 执行go build时没有显式指定-mod=vendor参数，即使有vendor目录也可能被Go工具链跳过，优先走mod缓存下载

FROM golang:1.14-alpine AS builder
RUN apk --update add ca-certificates git make g++
ENV GO111MODULE=on

WORKDIR /app

RUN go get github.com/go-delve/delve/cmd/dlv

# 先复制依赖相关文件，最大化利用构建缓存
COPY go.mod go.sum ./
# vendor目录不存在时才执行依赖下载
RUN if [ ! -d "vendor" ]; then go mod download -x; fi

# 复制整个项目代码（包含本地可能已经生成的vendor目录）
COPY . .

# vendor目录不存在时才执行生成逻辑
RUN if [ ! -d "vendor" ]; then go mod vendor; fi

ARG COMMIT_HASH
ENV COMMIT_HASH=${COMMIT_HASH}
ARG BUILD_DATE
ENV BUILD_DATE=${BUILD_DATE}

# 显式指定使用vendor目录构建，强制不走网络下载
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 \
    go build -mod=vendor \
    -o app

FROM golang:1.14-alpine

WORKDIR /app

COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ca-certificates.crt
COPY --from=builder /go/bin/dlv /
COPY --from=builder /app/app .
COPY --from=builder /app/db ./db
EXPOSE 8080 63342
CMD [ "/dlv", "--listen=:63342", "--headless=true", "--api-version=2", "--accept-multiclient", "exec", "./app" ]

• 调整了文件复制顺序，先复制go.mod和go.sum，只要这两个文件没有变化，依赖下载层的构建缓存就可以复用
• 新增了目录存在性判断：本地已经生成vendor目录的情况下，会跳过go mod download和go mod vendor两步，直接用复制进去的vendor文件
• 构建命令显式添加-mod=vendor参数，强制Go工具链优先使用vendor目录下的依赖，不会触发网络下载
• 完全兼容CI/未生成vendor的场景：如果检测不到vendor目录，会自动执行下载和生成逻辑，不影响原有流程
• 注意检查你的.dockerignore文件，如果里面有vendor相关的忽略规则需要删掉，避免本地vendor目录被构建进程过滤，导致无法复制到镜像内

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