go服务kubernetes部署失败主因是镜像、监听地址、探针三者未对齐：必须监听0.0.0.0:8080而非127.0.0.1，禁用cgo并多阶段构建，readiness/liveness探针路径与代码注册一致，且initialdelayseconds需匹配冷启动时长。
Go服务在Kubernetes里跑不起来，90%不是代码问题，而是没过 Deployment + 镜像 + 探针这三关。
Go二进制必须静态编译且监听 0.0.0.0:8080
本地能跑的 main.go 直接扔进容器大概率失败，因为默认 http.ListenAndServe(":8080", nil) 在容器里等同于监听 127.0.0.1:8080，而 Kubernetes 的 Service 流量是发到 Pod IP 的，根本进不来。
必须显式绑定网卡地址：
http.ListenAndServe("0.0.0.0:8080", nil)
同时构建时禁用 CGO，否则二进制会动态链接 libc，scratch 镜像直接报 no such file or directory 错误：
-
CGO_ENABLED=0是硬性要求 -
GOOS=linux避免 macOS/Windows 编译产物不兼容 - 多阶段 Dockerfile 中运行阶段别用
alpine带 shell 的镜像——除非你真需要sh调试，否则优先选scratch
Deployment 必须配 readinessProbe 和 livenessProbe
Kubernetes 不看进程是否活着，只认 HTTP 返回码。没配探针或路径不存在，Pod 会卡在 ContainerCreating 或反复重启。
你的 Go 代码里至少得注册两个 handler：
http.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
w.Write([]byte("OK"))
})
http.HandleFunc("/readyz", func(w http.ResponseWriter, r *http.Request) {
// 这里可以加 DB ping、依赖服务连通性检查
w.WriteHeader(http.StatusOK)
w.Write([]byte("ready"))
})
对应 YAML 中的 probe 配置不能只写 path: /：
-
livenessProbe.httpGet.path必须和代码里注册的路径一致（比如/healthz） -
initialDelaySeconds得设够：Go 启动快，但冷启动加载配置、连 DB 可能要 5–10 秒，设太小会触发误杀 -
readinessProbe失败时 Pod 不会收流量，但不会重启；livenessProbe失败才会重建容器
ConfigMap/Secret 注入配置，别用环境变量硬编码
很多人把数据库地址、密钥写死在代码里或用 os.Getenv("DB_URL") + env: 直接塞进 Deployment，这在 CI/CD 或多环境切换时极难维护，也容易泄露敏感信息。
正确做法是拆开：
- 用
ConfigMap管理非敏感配置（如日志等级、超时时间），挂载为文件或 env - 用
Secret存数据库密码、API Token，同样支持挂载或 env 引用 - Go 代码里统一从文件读取（比如
/etc/config/app.yaml），避免逻辑分散 - 千万别在 Dockerfile 里
ENV DB_URL=xxx——镜像就带密钥了，仓库一公开全完蛋
kubectl apply -f deployment.yaml 后，先看 Events 再查日志
执行部署后 Pod 没起来，第一反应不该是 kubectl logs，而是：
kubectl describe pod <pod-name></pod-name>
重点看 Events 区域，常见线索有：
-
Failed to pull image→ 镜像名写错、私有仓库没配imagePullSecret -
CrashLoopBackOff→ 探针失败或启动命令退出（比如端口被占、配置文件缺失） -
Back-off restarting failed container→ 容器启动后立刻崩溃，通常是 panic 或os.Exit(1) -
MountVolume.SetUp failed→ ConfigMap/Secret 名字拼错，或 key 不存在
真正该查日志，是确认 Pod 已 Running 但没响应请求时才做——这时候再 kubectl logs -c <container-name></container-name> 才有意义。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
