go服务在kubernetes中启动失败，主因是健康检查配置不当：未暴露/health和/ready端点，探针返回404致pod反复重启；/ready未校验db等依赖，导致流量导入后502；缺少resources和优雅关闭逻辑，引发oomkilled或连接丢失。
Go服务在Kubernetes中跑不起来，八成不是代码问题，而是容器生命周期没对齐——比如HTTP服务器没等就绪就收流量，或者SIGTERM来了没释放连接直接被杀。
Go服务必须暴露/health和/ready端点
Kubernetes的livenessProbe和readinessProbe默认走HTTP，但很多Go服务只写了/路由，探针一发404，Pod反复重启。
- 必须显式注册两个健康检查路径，且逻辑要区分：/health只检查进程存活（如能响应即可），/ready要验证依赖（DB连通性、缓存连接池是否就绪）
- 不要用
http.ListenAndServe裸奔，建议封装一层带超时控制的server，避免readinessProbe卡住整个Deployment扩缩容 - 如果用
gin或echo框架，别把健康检查路由写在中间件里——中间件可能因未初始化而panic，导致探针永远失败
示例片段：
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
w.Write([]byte("ok"))
})
mux.HandleFunc("/ready", func(w http.ResponseWriter, r *http.Request) {
if !dbPing() {
http.Error(w, "db unreachable", http.StatusServiceUnavailable)
return
}
w.WriteHeader(http.StatusOK)
w.Write([]byte("ready"))
})
http.ListenAndServe(":8080", mux)
}
Deployment里必须配resources和probe，不能只写replicas
没设resources会导致Kubernetes调度器乱分资源；没设readinessProbe会让新Pod刚启动就进Service Endpoint，结果请求全502。
-
resources.requests要填，否则Pod可能被调度到内存已满的节点，启动即OOMKilled -
livenessProbe.initialDelaySeconds至少设为30秒——Go二进制冷启动+依赖初始化常超10秒，设太小会触发无意义重启 -
readinessProbe.failureThreshold建议调高到3，默认1次失败就踢出Endpoint，网络抖动就丢流量
关键YAML片段：
containers:
- name: go-app
image: your-registry/go-app:v1.2
ports:
- containerPort: 8080
resources:
requests:
memory: "64Mi"
cpu: "100m"
limits:
memory: "128Mi"
cpu: "200m"
livenessProbe:
httpGet:
path: /health
port: 8080
initialDelaySeconds: 30
periodSeconds: 10
readinessProbe:
httpGet:
path: /ready
port: 8080
initialDelaySeconds: 5
periodSeconds: 5
failureThreshold: 3
Go程序必须捕获SIGTERM并优雅关闭
Kubernetes删Pod前发SIGTERM，默认行为是立刻退出。如果HTTP server正在处理长请求、DB事务没提交、日志缓冲区没刷盘，就会丢数据。
- 用
signal.Notify监听os.Interrupt和syscall.SIGTERM，别只监听Ctrl+C -
http.Server.Shutdown要传context.WithTimeout，超时后强制Close，防止死等 - 数据库连接池、gRPC client、消息队列消费者这些都要在Shutdown前显式关闭，顺序很重要：先停接收新请求，再等处理中任务完成，最后关下游连接
最小化优雅关闭结构：
srv := &http.Server{Addr: ":8080", Handler: mux}
go func() {
if err := srv.ListenAndServe(); err != http.ErrServerClosed {
log.Fatal(err)
}
}()
<p>quit := make(chan os.Signal, 1)
signal.Notify(quit, os.Interrupt, syscall.SIGTERM)
</p><p>ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
if err := srv.Shutdown(ctx); err != nil {
log.Fatal(err)
}</p>
真正容易被忽略的是：/ready探针返回200后，Kubernetes不会自动等你“准备好所有goroutine”，它只管把Pod加进Endpoint。所以依赖初始化（比如连接Redis、预热缓存）必须在/ready逻辑里做完，而不是放在main函数启动阶段——否则探针通过了，第一个请求进来却报错。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
