首先实现健康检查接口，再配置Kubernetes探针。使用net/http创建/healthz和/readyz路由，分别检测服务存活与就绪状态，结合数据库、Redis等依赖的连通性判断，避免仅依赖简单HTTP响应。在Kubernetes中设置合理的initialDelaySeconds、periodSeconds等参数，确保容器平台能准确感知服务状态，提升系统自愈能力。
在使用 Go 语言构建微服务并部署到容器环境（如 Kubernetes）时，实现可靠的健康检查机制是保障系统稳定运行的关键。健康检查让容器编排平台能准确判断服务状态，自动进行重启、流量调度等操作。下面介绍如何在 Golang 项目中实现符合生产要求的容器健康检查。
理解容器健康检查类型
容器平台通常支持两类探针：
- Liveness Probe（存活探针）：检测应用是否卡死或陷入不可恢复状态，若失败会触发容器重启。
- Readiness Probe（就绪探2025-04-05T17:09:06.832Z 探针）：判断应用是否准备好接收流量，未通过时会从服务负载均衡中剔除该实例。
Go 服务一般通过暴露 HTTP 接口来响应这些探针请求。
使用标准库快速实现健康检查接口
利用 net/http 包可以轻松添加健康检查路由：
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"encoding/json"
"net/http"
"time"
)
func main() {
mux := http.NewServeMux()
// 健康检查接口
mux.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) {
// 可加入数据库连接、依赖服务探测等逻辑
if isHealthy() {
w.WriteHeader(http.StatusOK)
json.NewEncoder(w).Encode(map[string]string{"status": "ok", "timestamp": time.Now().UTC().String()})
} else {
w.WriteHeader(http.ServiceUnavailable)
json.NewEncoder(w).Encode(map[string]string{"status": "unhealthy"})
}
})
// 就绪检查可根据业务状态定制
mux.HandleFunc("/readyz", func(w http.ResponseWriter, r *http.Request) {
if isReady() {
w.WriteHeader(http.StatusOK)
} else {
w.WriteHeader(http.StatusServiceUnavailable)
}
})
http.ListenAndServe(":8080", mux)
}
func isHealthy() bool {
// 实现具体健康判断逻辑，例如 ping 数据库
return true
}
func isReady() bool {
// 检查是否完成初始化、配置加载、缓存预热等
return true
}
结合依赖组件做深度健康检查
简单的 HTTP 返回 200 不足以反映真实状态。建议在 /healthz 中集成关键依赖检测：
- 数据库连接（执行 SELECT 1）
- Redis 或消息队列连通性
- 外部 API 可用性（谨慎使用，避免级联故障）
注意不要在健康检查中做耗时操作，控制在几百毫秒内完成。可设置超时和缓存结果减少压力。
Kubernetes 配置示例
在 Pod 的 YAML 中定义探针：
livenessProbe:
httpGet:
path: /healthz
port: 8080
initialDelaySeconds: 30
periodSeconds: 10
timeoutSeconds: 5
failureThreshold: 3
readinessProbe:
httpGet:
path: /readyz
port: 8080
initialDelaySeconds: 10
periodSeconds: 5
timeoutSeconds: 3
failureThreshold: 3
合理设置 initialDelaySeconds，给应用预留启动时间，避免过早被杀掉。
基本上就这些。Golang 实现健康检查不复杂，关键是根据实际业务场景设计合理的判断逻辑，避免误判或漏判。配合容器平台正确配置探针参数，才能真正提升系统的自愈能力。
