多阶段构建能将go微服务镜像从300mb以上压缩至12mb以内，通过分离构建与运行环境，仅复制静态二进制文件，避免嵌入编译器、goroot等冗余组件，并配合cgo_enabled=0和-ldflags="-s -w"实现轻量、安全、可移植的生产镜像。
Go微服务容器化不是“加个Dockerfile就完事”，关键在镜像体积、启动可靠性、网络可访问性三处——稍有疏忽，docker run 启动后立刻 Exit 1 或者 curl: (7) Failed to connect 是高频问题。
为什么用多阶段构建而不是单阶段？
单阶段镜像（比如直接 FROM golang:alpine 然后 CMD ["./main"]）会把 Go 编译器、$GOROOT、测试工具链全塞进生产镜像，体积常超 300MB；而多阶段只复制最终二进制，配合 alpine 或 distroless/static-debian12，能压到 12MB 以内。
- 构建阶段必须用完整 Go 镜像（如
golang:1.22-alpine），否则go mod download和go build会失败 - 运行阶段若用
scratch，需确认你的 Go 程序没调用os/exec或依赖系统命令（如sh、ls），否则启动直接 panic - 用
alpine而非ubuntu做运行基础镜像，是因为它自带apk包管理器，方便后续加ca-certificates（HTTPS 必需）
CGO_ENABLED=0 和 -ldflags="-s -w" 必须加吗？
必须。不加会导致两个典型问题：一是镜像在 Alpine 上运行时因找不到 libc 报 standard_init_linux.go:228: exec user process caused: no such file or directory；二是二进制含调试符号，体积翻倍且暴露内部路径。
-
CGO_ENABLED=0强制纯 Go 编译，避免依赖 C 标准库，是跨平台静态链接的前提 -
-ldflags="-s -w"中-s去除符号表，-w去除 DWARF 调试信息，二者缺一不可 - 如果程序里用了
cgo（比如调用 SQLite、OpenSSL），就不能设CGO_ENABLED=0，此时必须用alpine运行镜像并apk add sqlite-dev openssl-dev
容器启动后无法访问 localhost:8080 怎么排查？
不是端口映射写错了，而是 Go 服务默认绑定 127.0.0.1:8080，在容器里这个地址只对本容器 loopback 有效，外部宿主机根本连不上。
- Go 代码中必须显式监听
0.0.0.0:8080，而非localhost:8080或:8080（后者在某些 Go 版本里等价于127.0.0.1） -
Dockerfile里的EXPOSE 8080只是文档作用，不影响实际行为；真正起效的是docker run -p 8080:8080 - 检查容器日志：
docker logs <container_id></container_id>，如果看到listen tcp 127.0.0.1:8080: bind: cannot assign requested address，说明进程根本没起来——大概率是配置读取失败或数据库连接超时导致main()提前退出
健康检查 HEALTHCHECK 怎么写才不误杀？
用 wget 或 curl 做健康检查很常见，但 Alpine 镜像默认不带 wget，curl 也要手动装；更稳妥的方式是用 Go 自身的 net/http 发起本地请求，或者直接用 cmd 执行 kill -0 1 判断主进程是否存在。
- 推荐写法：
HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 CMD http://localhost:8080/healthz || exit 1——但前提是镜像里真有curl - 更轻量方案：在 Go 服务里加一个
/healthzhandler，返回 HTTP 200；然后HEALTHCHECK CMD wget --quiet --spider --timeout=2 http://localhost:8080/healthz || exit 1，并在运行阶段RUN apk add --no-cache wget - 注意
--start-period必须设够长（至少 10s），否则服务还没初始化完就被判定为 unhealthy，容器反复重启
最易被忽略的点：Go 应用默认不处理 SIGTERM，容器 docker stop 时会强制 kill，可能丢数据。务必在 main() 里监听 os.Interrupt 和 syscall.SIGTERM，做 graceful shutdown。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
