Go服务容器化必须兼顾静态编译（CGO_ENABLED=0）、多阶段构建（分离依赖与源码复制以复用缓存）和信号处理（SIGTERM触发优雅关闭），三者缺一不可，否则将导致运行失败、镜像臃肿或滚动更新丢请求。
Go 服务容器化不是“写完代码再打包”，而是从 main 函数设计、编译参数到 Dockerfile 分阶段逻辑，全程需对齐容器生命周期。静态二进制 + 多阶段构建 + 信号响应，三者缺一不可。
CGO_ENABLED=0 必须显式设置，否则 Alpine 镜像启动就报错
不加这个参数，go build 默认启用 CGO，生成的二进制依赖 glibc；而 Alpine 使用 musl libc，运行时直接失败：
standard_init_linux.go:228: exec user process caused: no such file or directory
这不是路径问题，是动态链接器找不到。解决方式只有在构建命令里硬编码关掉：
CGO_ENABLED=0 GOOS=linux go build -o mysvc ./cmd/server- 即使你用 Ubuntu 基础镜像，也建议关——镜像体积小 40MB+，且避免 libc 升级引发的兼容性断裂
- 如果项目真依赖 cgo（如调用 C 库），那就不能用 Alpine，得切回
debian:slim或ubuntu:22.04，并安装对应 dev 包
Dockerfile 多阶段构建必须分离 go.mod/go.sum 和源码 COPY
否则每次改代码都会触发 go mod download 重跑，彻底浪费 Docker 缓存。正确顺序是：
立即学习“go语言免费学习笔记（深入）”；
- 先
COPY go.mod go.sum ./，再RUN go mod download—— 这步缓存可复用 - 然后
COPY . .，此时才复制源码，避免因代码变更导致依赖下载被跳过 - 构建阶段用
golang:1.23-alpine，运行阶段用alpine:latest或scratch（后者需确认无证书依赖） - 运行阶段记得
RUN apk --no-cache add ca-certificates，否则 HTTPS 请求（数据库、API 调用）会因证书缺失失败
main 函数里不处理 SIGTERM，Kubernetes 滚动更新就会丢请求
K8s 发 SIGTERM 后，若 Go 程序没监听，30 秒超时直接 SIGKILL 强杀。必须显式捕获并触发 http.Server.Shutdown()：
- 不能只写
log.Fatal(err)或os.Exit(1)—— 这等于放弃优雅关闭 - Shutdown 要传 context，设超时（比如 10s），等活跃 HTTP 连接自然结束
- DB 连接池、gRPC client、消息消费者等，必须在
srv.Shutdown()返回后再关闭，顺序颠倒会导致 panic 或资源泄漏 - 探针端点（如
/readyz、/livez）要和实际状态联动：就绪探针返回 200 前，必须确保 DB 连通、配置加载完成
镜像体积超过 20MB，大概率是构建阶段没清理或用了错误基础镜像
一个纯 Go 微服务最终镜像应稳定在 12–18MB（alpine）或 6–10MB（scratch）。超标常见原因：
- 构建阶段用了
golang:latest直接做运行镜像 —— 它含完整 Go 工具链，体积 > 1GB - 运行阶段没用
COPY --from=builder，而是把整个/app目录 COPY 过去，包含go.mod、测试文件、vendor 等冗余内容 - 忘了
CGO_ENABLED=0，导致二进制带动态链接信息，Alpine 下又额外装了 glibc 兼容层 - 日志没结构化、没禁用 debug 输出，导致 stdout 冗余刷屏，虽不影响体积，但干扰可观测性
真正难的不是写出能跑的 Dockerfile，而是让每个环节都对齐容器语义：编译即交付、信号即契约、探针即承诺。漏掉任意一环，上线后都会在流量高峰或滚动发布时暴露出来。
