

新闻资讯
技术学院Liveness探针用/healthz端点检查进程存活,Readiness探针用/readyz端点检查服务就绪;前者轻量无依赖,后者验证外部依赖与初始化状态;均需200表示通过,避免阻塞。
在 Go 应用中实现 Kubernetes 的 Readiness 和 Liveness 探针,核心是暴露两个独立的 HTTP 端点,分别返回不同语义的健康状态,且逻辑要严格区分:Liveness 判断进程是否“还活着”,Readiness 判断服务是否“可接收流量”。
不要复用同一个接口。推荐路径如下:
两者都应返回 200 OK 表示通过,非 200(如 503)表示失败。K8s 默认超时 1 秒、失败阈值 3 次,建议在 handler 中避免阻塞或长耗时操作。
Liveness 必须快、稳、不依赖外部系统。一个典型实现:
http.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) {
// 只做最基础检查:时间是否正常、内存是否严重告警(可选)
if time.Since(startTime) < 0 {
http.Error(w, "clock skew detected", http.StatusInternalServerError)
return
}
w.WriteHeader(http.StatusOK)
w.Write([]byte("ok"))
})⚠️ 注意:不要在这里查 DB 或 Redis —— 它挂了应该触发重启(Liveness 失败),而不是让整个探针变慢或误判。
Readiness 要反映真实服务能力。常见检查项:
SELECT 1 或检查连接池状态)示例片段:
var dbReady = atomic.Bool{}
// 启动时异步检查 DB 并设置标志
go func() {
for i := 0; i < 3; i++ {
if err := db.Ping(); err == nil {
dbReady.Store(true)
return
}
time.Sleep(2 * time.Second)
}
}()
http.HandleFunc("/readyz", func(w http.ResponseWriter, r *http.Request) {
if !dbReady.Load() {
http.Error(w, "database not ready", http.StatusServiceUnavailable)
return
}
w.WriteHeader(http.StatusOK)
w.Write([]byte("ready"))
})
关键参数要匹配 Go 服务实际行为:
httpGet 指向 /healthz,initialDelaySeconds: 10(给应用冷启动留时间)/readyz,initialDelaySeconds: 5(可比 liveness 更早开始)
timeoutSeconds: 2、periodSeconds: 5,避免默认 1 秒超时导致频繁失败示例片段:
livenessProbe:
httpGet:
path: /healthz
port: 8080
initialDelaySeconds: 10
timeoutSeconds: 2
periodSeconds: 5
readinessProbe:
httpGet:
path: /readyz
port: 8080
initialDelaySeconds: 5
timeoutSeconds: 2
periodSeconds: 5基本上就这些。重点不是写得多,而是两个探针职责分明:Liveness 守住进程底线,Readiness 把控流量入口。不复杂但容易忽略 —— 很多线上问题其实源于 readiness 检查太松(一直 200 却实际不可用)或太紧(依赖抖动就切走流量)。