Go服务K8s健康检查失败主因是探针配置、端点实现、依赖探测三者未对齐:如/readyz路径未注册、db.Ping无超时、用框架路由而非原生ServeMux暴露探针,且两探针不可共用路径。

Go服务在Kubernetes里健康检查失败,90%不是代码写错,而是探针配置、端点实现、依赖探测三者没对齐——比如readinessProbe指向/health,但代码根本没注册这个路由;或/readyz里调了db.PingContext却没设超时,导致每次探测卡住10秒被Kubelet判定为失败。
为什么curl能通但livenessProbe一直失败
常见现象:手动curl http://pod-ip:8080/healthz返回200,但Pod反复重启。本质是Kubelet的探测行为和人肉curl不一致。
- Kubelet默认
timeoutSeconds: 1,而你的handler里有time.Sleep(2 * time.Second)或没设http.Server.ReadTimeout,导致响应超时 - 用了
http.DefaultServeMux,被其他包(如pprof)悄悄注册了同名路径,实际响应的是pprof的调试页而非你的健康逻辑 - 响应体为空:
w.WriteHeader(200)后没写任何body,旧版kubelet会判为失败;必须w.Write([]byte("ok"))或至少设Content-Type - 用了HTTPS但
livenessProbe配的是httpGet,或者Service没开appProtocol: http导致Ingress拦截重定向
readinessProbe超时却查不到日志
没日志≠没触发,而是探针请求根本没进你的handler——它被中间件、路由匹配或TLS握手阶段拦下了。
- 别用Gin/Echo等框架的
GET("/readyz")注册探针端点:中间件链可能panic、加header、或延迟响应;改用原生http.ServeMux单独起一个http.Server监听:8081 - 检查
netstat -tuln | grep :8081确认端口真在监听;很多Go服务只监听:8080,但readinessProbe却配了port: 8081 - 如果用了gRPC,
readinessProbe不能走HTTP GET:必须用grpc_health_v1实现Health Check,并在Service YAML中显式声明appProtocol: grpc - 容器内
curl -v http://localhost:8081/readyz失败?说明端点根本没跑起来——检查main()里是否漏了go healthServer.ListenAndServe(),或ListenAndServe阻塞了主线程
probe配置参数怎么调才不误杀
参数不是越严越好,要匹配Go服务的真实启动节奏和依赖恢复能力。
-
initialDelaySeconds必须≥服务冷启动耗时:比如加载大配置、初始化gRPC连接池需8秒,那readinessProbe.initialDelaySeconds至少设10,否则流量提前涌入 -
failureThreshold和periodSeconds要防抖:DB临时抖动2秒,若periodSeconds: 5+failureThreshold: 1,一次失败就摘流量;应设failureThreshold: 3,允许连续3次失败才动作 -
timeoutSeconds必须<探测间隔:若timeoutSeconds: 5但periodSeconds: 3,Kubelet还没等超时就发下一次,goroutine堆积最终OOM - 两个probe绝不能共用路径:
livenessProbe用/livez(只查atomic.LoadInt32(&healthy)),readinessProbe用/readyz(查DB/Redis/gRPC),混用会导致滚动更新卡死
依赖探测为什么总连不上数据库
不是网络不通,而是探测方式本身在制造压力。
- 每次
/readyz都调db.PingContext(ctx, 2*time.Second)?这会新建连接,高频探测下连接池瞬间打满;正确做法是后台用time.Ticker每5秒检查一次,结果缓存到sync.RWMutex保护的结构体,handler只读快照 - 没复用全局
*sql.DB:在handler里sql.Open(...)再Ping,fd泄漏+DNS重复解析,很快报too many open files - context没设超时:
db.PingContext(context.Background(), ...)会让探测无限等待;必须用ctx, cancel := context.WithTimeout(context.Background(), 1500*time.Millisecond) - 错误处理太粗暴:
if err != nil { http.Error(w, "db down", 503) }掩盖了真实原因;应记录zap.Error(err)并返回JSON含具体组件状态,比如{"db": "timeout", "redis": "OK"}
最易被忽略的点:健康端点必须完全脱离业务代码路径——不import业务包、不读os.Getenv、不碰ConfigMap内容。哪怕只是多调了一次os.ReadFile("config.yaml"),在ConfigMap热更新时就可能因文件锁导致探针阻塞。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











