Go微服务部署关键卡点在于编译、镜像构建与K8s更新三步衔接：必须显式指定GOOS=linux和GOARCH=amd64（或arm64）交叉编译，避免exec format error；Dockerfile中ENTRYPOINT需用绝对路径指向静态二进制；kubectl apply后须用rollout status校验滚动更新完成，而非仅提交YAML。
Go 微服务部署流水线不是“配好 Jenkins 或 GitHub Actions 就能跑通”，关键卡点在编译、镜像构建、K8s 更新三步的衔接是否干净——尤其是 go build 产出的二进制能否在目标容器里真正执行，以及 kubectl rollout status 是否真能反映滚动更新完成。
GOOS 和 GOARCH 必须显式指定，否则镜像里跑不起来
本地 macOS 或 Windows 上 go build 出来的二进制，放到 Linux 容器里直接报 exec format error。这不是环境变量或权限问题，是架构不匹配。
-
GOOS=linux GOARCH=amd64 go build -o ./bin/service ./cmd/service是最低要求；若需支持 ARM 服务器（如阿里云 C6 实例），得额外加GOARCH=arm64 - 推荐统一用
-ldflags="-s -w"去掉符号表和调试信息，二进制体积减少 30%+，对镜像分层更友好 - 别依赖
CGO_ENABLED=0默认值——显式写上更稳妥：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build ...，避免某些 cgo 依赖意外触发
Dockerfile 中 ENTRYPOINT 路径写错，容器启动就退出
常见错误现象：docker run 启动后立刻退出，docker logs 显示 exec: "main": executable file not found in $PATH。本质是镜像里找不到可执行文件，或路径没对上。
- 确保
COPY的路径与ENTRYPOINT一致，例如：COPY ./bin/service /app/service→ENTRYPOINT ["/app/service"] - 不要用
CMD ["./service"]，它依赖WORKDIR，容易因上下文切换失效；ENTRYPOINT绝对路径更可靠 - 基础镜像优先选
gcr.io/distroless/static:nonroot或scratch，避免引入无关 libc，也倒逼你确认二进制真是静态链接
CI 流水线里 kubectl apply 后不能直接认为部署完成
kubectl apply -f deployment.yaml 只是提交变更，K8s 需要时间拉镜像、调度 Pod、运行探针。很多流水线在这里埋坑：下一步就发通知或调用接口，结果服务还没 ready。
- 必须加等待逻辑：
kubectl rollout status deployment/my-service --timeout=120s，超时直接失败，不靠 sleep 猜时间 - 健康检查端点（如
/health）要在代码里真实返回 200，且 K8slivenessProbe和readinessProbe的initialDelaySeconds和periodSeconds要匹配服务冷启动时间 - 如果用
kustomize管理多环境，确保kubectl apply -k overlays/prod/中的namePrefix或namespace不和预发布环境冲突
Makefile 或 CI 脚本里没清理临时文件，导致镜像越打越大
Go 编译产物、测试覆盖率报告、go mod download 缓存，全塞进最终镜像层，一次部署可能多出 100MB+ 无用体积。
- Dockerfile 用多阶段构建：
FROM golang:1.21 AS builder编译，再FROM scratchCOPY 二进制，彻底隔离构建依赖 - CI 脚本中
go test后立即rm -f coverage.out；go mod download前先go clean -modcache（尤其在共享 runner 上） - Makefile 里定义
clean:目标，每次make build前自动清掉./bin/和./dist/
最易被忽略的是：K8s Deployment 的 imagePullPolicy 在 CI 推送新镜像后仍为 IfNotPresent，导致旧 Pod 重启时拉不到最新版——务必设成 Always，或用带 commit hash 的镜像 tag 配合 imagePullPolicy: IfNotPresent。
