Docker构建Go API时go mod download重复拉取模块问题及优化咨询

为什么go mod download第二次构建仍显示拉取模块但速度快？ #

你看到的"拉取每个模块"并不是真的重新下载，而是Go在检查本地缓存（也就是你用--mount=type=cache挂载的/go/pkg/mod）里的模块版本是否和go.mod/go.sum完全匹配。

第一次运行go mod download时，Go会把依赖完整下载到缓存目录；第二次构建时，它会快速校验缓存内模块的哈希值是否与go.sum一致，只要匹配就不会重新下载，只是输出校验过程的日志，所以速度依然很快。这是Go模块机制的正常行为，无需担心重复下载的问题。

Dockerfile优化建议 #

• 合并冗余RUN命令，减少镜像层：把安装shadow工具和创建用户的命令合并，避免生成多余的镜像层：

  RUN apk add --no-cache shadow && useradd -u 1000 go
  

• 添加编译参数减小二进制体积：在go build中加入-ldflags="-s -w"，去掉符号表和调试信息，能显著缩小二进制文件大小：

  RUN go build -ldflags="-s -w" -o ./binary
  

  如果需要进一步压缩，可在build阶段安装upx后对二进制文件进行压缩，但注意这可能影响部分调试工具的使用。

• 解决HTTPS请求证书问题：scratch镜像默认没有根证书，若你的API需要调用HTTPS服务，会导致请求失败。可从build阶段复制证书到运行镜像：

  COPY --from=build /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
  

• 移除不必要的环境变量：GO111MODULE=on在Go 1.16及以上版本已是默认值，这个环境变量可以直接删除。

优化后的完整Dockerfile #

# 构建阶段
FROM golang:1.23rc2-alpine3.20 AS build
WORKDIR /app

# 复制依赖文件并下载（最大化缓存利用率）
COPY ./go.mod ./go.sum ./
RUN --mount=type=cache,target=/go/pkg/mod \
    go mod download

# 安装工具并创建非root用户
RUN apk add --no-cache shadow && useradd -u 1000 go

# 复制代码并构建
COPY . .
RUN go build -ldflags="-s -w" -o ./binary

# 运行阶段
FROM scratch
ENV GIN_MODE=release
EXPOSE 8080

# 复制HTTPS根证书（按需添加）
COPY --from=build /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
# 复制用户信息和二进制文件
COPY --from=build /etc/passwd /etc/passwd
COPY --from=build /app/binary .

USER go
CMD ["./binary"]

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