/livez只检查进程是否存活,响应须≤1秒、不查DB;/readyz才查DB等依赖,两者必须分离,否则依赖抖动将引发CrashLoopBackOff。

必须分开 /livez 和 /healthz,否则依赖抖动会触发无限重启;Kubernetes 不会“自动修复”,它只按配置杀或摘流量,真正要靠 Go 代码自己暴露端点、控制状态、配合探针语义。
为什么 /livez 不能查数据库
查 DB = 网络 I/O + 连接池竞争 + 超时风险。一旦下游临时不可用,livenessProbe 失败 → K8s 杀 Pod → 新 Pod 启动后仍连不上 → 再次失败 → CrashLoopBackOff。这不是健康检查,是自毁循环。
-
/livez只回答一个问题:“进程自己还在跑吗?” 检查项限于:atomic.LoadInt32(&isHealthy)、runtime.NumGoroutine()是否突增、HTTP server 是否仍在Accept() - 响应必须 ≤1 秒,不发日志,不走中间件(Gin/Echo 要用
NoRoute或SkipMiddleware = true) - 别用
http.Get去轮询自己——直接监听本地 listener 是否存活更可靠
/healthz 和 /readyz 怎么分工
/healthz 是过时叫法,Kubernetes 官方推荐用 /readyz 表达就绪语义;/livez 专用于存活,/readyz 才该探测真实业务依赖。
-
/readyz可查 DB:db.PingContext(ctx, 500*time.Millisecond),每个依赖单独超时,用errgroup.Group并发执行 - 缓存检查结果(比如 10 秒内复用),避免每秒都打一次 Redis 或下游 gRPC
- 收到
SIGTERM后立刻设atomic.StoreInt32(&isReady, 0),让/readyz返回 503,K8s 自动摘流量
Kubernetes 探针参数怎么配才不打架
两个探针指向同一个 handler 是最常见错误,后果是滚动更新卡住、或服务明明挂了却一直收流量。
立即学习“go语言免费学习笔记(深入)”;
-
initialDelaySeconds:Go 启动慢(加载配置、初始化 client),livenessProbe至少设 20s,readinessProbe可设 10s,但不能比实际就绪时间短 -
failureThreshold × periodSeconds要大于依赖抖动窗口。例如 DB 抖动持续 3 秒,别用periodSeconds: 5+failureThreshold: 1,应调成failureThreshold: 3 -
timeoutSeconds必须比依赖调用超时多留 100ms 缓冲,比如 DB Ping 设了 400ms,探针timeoutSeconds至少 500ms
Go 里怎么避免健康检查 goroutine 泄漏
热重启时旧 time.Ticker 没停,新 ticker 又起,多个 goroutine 并发改同一变量,接口返回 “ok” 但实际已断连。
- 所有后台检查必须用
context.WithCancel包裹,Shutdown()时显式调ticker.Stop() - 共享状态(如
redisHealthy)必须用sync/atomic或sync.RWMutex保护,禁止裸写 - 别在 handler 里实时探测——用定时 goroutine 预检并缓存结果,handler 只读缓存
最容易被忽略的是:K8s 探针本身不带上下文,所有依赖调用必须手动加 context.WithTimeout,且超时值要严格小于探针配置的 timeoutSeconds,否则探针先超时杀掉请求,你的 defer 清理逻辑根本没机会执行。


















