在Go服务中实现健康检查需暴露/healthz和/ready接口，分别用于存活与就绪探测，结合HTTP状态码与依赖检测，并在Docker或Kubernetes中配置livenessProbe和readinessProbe，确保容器生命周期管理准确可靠。
在Go语言中实现容器健康检查，关键在于提供一个可被外部系统（如Kubernetes、Docker或负载均衡器）定期探测的接口。这个接口通常是一个HTTP端点，用于返回服务当前的运行状态。以下是具体实现方式和最佳实践。
1. 添加健康检查HTTP接口
最常见的方式是暴露一个/healthz或/health的HTTP路由，返回简单状态码。
示例代码：
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"net/http"
"log"
)
func healthz(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
w.Write([]byte("OK"))
}
func main() {
http.HandleFunc("/healthz", healthz)
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("Hello World"))
})
log.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", nil))
}
访问http://localhost:8080/healthz时，如果服务正常，返回200状态码和"OK"内容。
2. 实现更复杂的健康判断逻辑
除了简单存活检查，还可以加入对数据库、缓存、下游依赖等的连通性验证。
示例：检查数据库连接
func healthz(db *sql.DB) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
ctx, cancel := context.WithTimeout(r.Context(), 1*time.Second)
defer cancel()
if err := db.PingContext(ctx); err != nil {
http.Error(w, "DB unreachable", http.StatusServiceUnavailable)
return
}
w.WriteHeader(http.StatusOK)
w.Write([]byte("OK"))
}
}
这样，当数据库无法连接时，健康检查会失败，触发容器重启或从服务发现中剔除。
3. 配置Docker和Kubernetes探针
在容器化部署中，需要在Dockerfile或Kubernetes配置中声明健康检查方式。
Dockerfile 示例：
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
CMD curl -f http://localhost:8080/healthz || exit 1
Kubernetes Deployment 示例片段：
livenessProbe:
httpGet:
path: /healthz
port: 8080
initialDelaySeconds: 10
periodSeconds: 10
readinessProbe:
httpGet:
path: /healthz
port: 8080
initialDelaySeconds: 5
periodSeconds: 5
livenessProbe用于判断是否重启容器，readinessProbe用于控制流量是否转发到该实例。
4. 区分就绪与存活检查
实际应用中建议分开两个接口，处理不同场景。
- /healthz – 存活检查：服务进程是否在运行
- /ready – 就绪检查：是否可以接收流量（例如已完成初始化、依赖服务可用）
例如，服务启动时可能需要加载大量缓存，在加载完成前不应接收请求，此时/ready返回500，而/healthz仍为200。
基本上就这些。通过添加简单的HTTP健康接口，并结合容器平台的探针机制，就能有效管理Go服务的生命周期。关键是根据实际依赖设计合理的检查逻辑，避免误判。
