健康检查接口必须返回200 OK状态码，因负载均衡器和K8s livenessProbe默认仅认200为存活；不可混用就绪检查或在其中执行耗时依赖检测，应通过异步预检+缓存保障毫秒级响应。

健康检查接口该返回什么状态码

健康检查接口必须返回 200 OK，不能用 204 No Content 或 302 之类的状态。很多负载均衡器（如 AWS ALB、Nginx Plus）和 K8s livenessProbe 默认只认 200 才判定为“存活”。哪怕你返回 JSON {"status": "ok"} 却配了 503，服务就会被反复重启。

常见错误：把健康检查和“就绪检查”混用，或在健康检查里偷偷查数据库连接——一旦 DB 挂了，livenessProbe 失败触发重启，反而加剧雪崩。

用 net/http 写最简健康检查 handler

不需要引入任何第三方框架，标准库一行就能写清楚：

http.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
    w.WriteHeader(http.StatusOK)
    w.Write([]byte("ok"))
})

注意点：

立即学习“go语言免费学习笔记（深入）”；

• w.WriteHeader(http.StatusOK) 必须显式调用，否则默认是 200，看似没问题，但某些严格校验的探针会要求 header 明确声明
• 避免用 fmt.Fprint，它可能隐式写入额外空格或换行，某些客户端解析失败
• 不要在 handler 里做耗时操作（如调用 time.Sleep 模拟检测），K8s 默认超时是 1 秒，超时即判为失败

需要检查依赖时怎么设计不拖垮主路径

真正的生产健康检查常需验证数据库、Redis、下游 HTTP 服务是否可达。但这些检查不能阻塞主健康接口——否则一个 Redis 延迟，整个服务就被标记为不健康。

推荐做法是异步预检 + 缓存结果：

• 启动时开 goroutine 定期（如每 10 秒）探测依赖，结果存进内存变量（如 atomic.Value 或带锁 map）
• /health handler 只读缓存，毫秒级返回
• 加个 /healthz?verbose=1 作为调试端点，手动触发实时检测（仅限内网访问）

示例关键逻辑：

var healthStatus atomic.Value // 存 map[string]bool
healthStatus.Store(map[string]bool{"db": true, "redis": true})
go func() {
ticker := time.NewTicker(10 * time.Second)
defer ticker.Stop()
for range ticker.C {
status := map[string]bool{
"db":     pingDB(),
"redis":  pingRedis(),
}
healthStatus.Store(status)
}
}()
http.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
if r.URL.Query().Get("verbose") == "1" {
// 调试用，跳过缓存，实时探测（建议加 IP 白名单）
...
return
}
statuses := healthStatus.Load().(map[string]bool)
for _, ok := range statu
ses {
if !ok {
w.WriteHeader(http.StatusServiceUnavailable)
w.Write([]byte("dependency failed"))
return
}
}
w.WriteHeader(http.StatusOK)
w.Write([]byte("ok"))
})

K8s livenessProbe 和 readinessProbe 怎么配

两者必须分开，不能都指向 /health：

• livenessProbe：只检查进程是否卡死（比如 goroutine 泄漏、死锁），建议用极简版（不查依赖），失败后容器重启
• readinessProbe：检查服务是否准备好接收流量，可包含依赖检测，失败后从 service endpoint 中摘除，但不重启

典型 YAML 片段：

livenessProbe:
  httpGet:
    path: /health
    port: 8080
  initialDelaySeconds: 30
  periodSeconds: 10
  timeoutSeconds: 2
readinessProbe:
  httpGet:
    path: /readyz
    port: 8080
  initialDelaySeconds: 5
  periodSeconds: 5
  timeoutSeconds: 2

注意：/readyz 应该比 /health 更严格，且它的响应时间必须稳定——如果某次 Redis 探测慢了 3 秒，K8s 就会把它从 endpoints 列表里踢出去，即使服务本身完全正常。