Golang如何做Docker多阶段构建_Golang Docker教程【秒懂】-Golang-PHP中文网

go镜像体积大是因为未用多阶段构建，直接将编译环境打包进运行镜像；正确做法是用golang:slim构建、cgo_enabled=0静态编译、alpine作基础镜像，并验证dns与证书。

golang如何做docker多阶段构建_golang docker教程【秒懂】

因为你没分阶段，直接用 golang:latest 或 golang:alpine 构建完就当运行镜像用了——编译器、go.mod、$GOPATH、测试文件全塞进去了，Docker 层也没清理。

Go 编译产物是静态二进制（前提是关掉 CGO），根本不需要 /bin/sh、apk、git，更不依赖 glibc。多阶段构建就是靠两个 FROM 指令物理隔离：一个装工具链只编译，一个空着身子只跑程序。

FROM golang:1.22-slim AS builder —— 用 -slim 而非 latest，tag 固定，CI 可复现
RUN CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-s -w' -o /app/main . —— -s -w 去符号表和调试信息，体积直降 30%~50%
别在 builder 阶段 RUN rm -rf $GOPATH，那只是删文件，层还在，镜像大小不变

不是所有 Go 程序都能扔进 scratch。它真的一无所有：没有 /etc/resolv.conf、没有 /dev/null、没有 /tmp，连 os.UserHomeDir() 都会 panic。

典型报错：lookup example.com: no such host 或 exec user process caused: no such file or directory（其实是找不到动态加载器）。

Golang Samber Do

使用 samber/do 在 Golang 中实现依赖注入 — 服务容器、生命周期管理、作用域、健康检查、优雅关闭和模块组织

下载

优先用 FROM alpine:3.19：体积仅 ~5MB，自带 musl libc、DNS 配置、/dev 和 /tmp，兼容性远超 scratch
非要上 scratch？得手动补证书、/etc/resolv.conf、/dev/null，还得确保二进制真静态：file ./main 输出含 statically linked
如果用了 net/http 发 HTTPS 请求，alpine:latest 必须 apk add --no-cache ca-certificates，否则 x509: certificate signed by unknown authority

Go 1.20+ 默认启用 CGO，哪怕你没写一行 C 代码——只要依赖了 net、os/user、os/exec，就可能动态链接 libc。一放进 scratch 或 distroless，立刻崩溃。

错误现象：standard_init_linux.go:228: exec user process caused: no such file or directory，不是文件丢了，是缺动态加载器。

必须显式写 CGO_ENABLED=0，不能靠“应该默认关了吧”这种猜测
GOOS=linux 必须带上，否则在 macOS 上构建可能产出 Darwin 二进制
若项目真用了 cgo（比如 SQLite、OpenSSL 绑定），别硬刚 scratch，改用 gcr.io/distroless/cc 或 alpine + 对应 dev 包

COPY --from=builder 里的 builder 是你起的名字，不是关键字。拼错、漏写 AS builder、或用数字序号 --from=0，Docker 构建不会报错，但 COPY 实际什么也没复制——最后运行时提示 command not found。

验证方法很简单：docker run --rm -it your-image ls -l /，看目标路径下有没有二进制文件。

务必显式命名：FROM golang:1.22-slim AS builder
避免用 --from=0：重构 Dockerfile 增加阶段后，序号全乱，--from=0 就指向错的阶段
builder 阶段的 WORKDIR 和 COPY 路径要对齐，比如 COPY . . 后 go build -o /app/main，final 阶段就得 COPY --from=builder /app/main /app/main