go服务上k8s交付卡点在于构建兼容性、运行时环境缺失及生命周期不匹配：需显式cgo_enabled=0和goos=linux交叉编译，builder阶段执行go mod tidy校验依赖，livenessprobe须用/healthz等真实就绪检查而非端口探测，entrypoint或代码中需优雅处理sigterm。
Go 服务上 K8s 不是“配个 YAML 就完事”，真正卡住交付的，是构建阶段的二进制兼容性、运行时环境缺失、以及 K8s 资源定义与 Go 进程生命周期不匹配这三处。
go build 时 CGO_ENABLED=0 和 GOOS=linux 必须显式指定
本地 macOS 或 Windows 上直接 go build 出来的二进制，在 Alpine 或 distroless 镜像里大概率 panic：找不到动态链接库，或启动即 segfault。这不是 Dockerfile 写得不对，是构建环境没对齐。
-
CGO_ENABLED=0关闭 C 语言绑定，避免依赖 libc（Alpine 用的是 musl） -
GOOS=linux强制目标操作系统为 Linux，哪怕你在 Mac 上构建 - 推荐写法：
CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-s -w' -o server .，其中-s -w去掉符号表和调试信息，可再减 3–5MB 体积
Docker 多阶段构建中 builder 阶段必须包含 go mod tidy
很多团队把 go.mod 和 go.sum COPY 进 builder 后就直接 go build，结果在 CI 环境里失败——因为 go build 默认不会校验 checksum，而 go mod download 或 go mod tidy 才会触发校验并拉取确切版本。
- builder 阶段务必先
RUN go mod tidy，而不是只靠COPY go.mod go.sum . - 如果项目用了 replace 指向本地路径（如
replace example.com/foo => ./foo），go mod tidy会报错：路径不存在——此时需在 COPY 源码前先COPY foo/ ./foo/ - 不执行
tidy的后果：镜像能构建成功，但 runtime 可能因依赖版本漂移而 panic（比如某间接依赖升级后破坏了接口）
K8s Deployment 中 livenessProbe 不能只检查端口是否 open
Go HTTP 服务启动快，http.ListenAndServe 返回即代表监听已建立，但业务初始化（如 DB 连接池 warmup、配置加载、gRPC client 初始化）可能还在进行中。此时仅靠 tcpSocket 探针会误判为健康，导致流量涌入未就绪实例。
- 必须用
httpGet指向一个真实 handler，例如/healthz，该 handler 内部应检查关键依赖是否 ready - 不要复用
/或/metrics：前者可能含业务逻辑，后者通常无权限控制且不反映服务就绪状态 - 示例 handler：
func healthz(w http.ResponseWriter, r *http.Request) { if db.Ping() == nil && cache.IsReady() { w.WriteHeader(http.StatusOK) } else { w.WriteHeader(http.StatusServiceUnavailable) } }
entrypoint 脚本里别直接 exec ./server，要捕获 SIGTERM
Go 程序默认响应 SIGTERM 并立即退出，但 K8s 发送 TERM 后只有 30 秒（默认 terminationGracePeriodSeconds）宽限期。若此时有正在处理的 HTTP 请求或 Goroutine 正在写日志，直接退出会导致连接中断或数据丢失。
- 入口点应包装一层信号转发逻辑，例如用
sh -c 'trap "kill -TERM $PID; wait $PID" TERM; ./server & PID=$!; wait $PID' - 更稳妥的做法是在 Go 代码里用
signal.Notify监听os.Interrupt和syscall.SIGTERM，优雅关闭 HTTP server（调用srv.Shutdown）后再退出 - 忽略这点的典型现象：K8s 重启 Pod 后，客户端偶发 502/504，日志里看不到 graceful shutdown 记录
最常被跳过的其实是健康检查 handler 的实现粒度——它不该只是 “端口通”，而要真实反映业务就绪态；这个逻辑一旦漏掉，自动化扩缩容就从保障变成风险源。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
