健康检查通过暴露/health接口保障微服务稳定性，Golang中可用net/http或Gin实现基础响应，支持数据库、缓存等依赖状态检测，并与Kubernetes、Consul集成实现自动监控与服务注册。
微服务健康检查是保障系统稳定性的重要手段。在 Golang 中实现健康检查，通常通过暴露一个 HTTP 接口（如 /health 或 /ping），供外部监控系统或服务注册中心定期探测。以下是具体实现方式和最佳实践。
1. 基础健康检查接口
使用标准库 net/http 快速搭建一个健康检查端点：
package main
import (
"encoding/json"
"net/http"
)
func healthHandler(w http.ResponseWriter, r *http.Request) {
// 简单返回 JSON 格式状态
status := map[string]string{"status": "ok", "message": "Service is running"}
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(status)
}
func main() {
http.HandleFunc("/health", healthHandler)
http.ListenAndServe(":8080", nil)
}
访问 http://localhost:8080/health 返回：
{
"status": "ok",
"message": "Service is running"
}
2. 扩展依赖健康检查
实际场景中，服务可能依赖数据库、缓存、消息队列等。健康检查应反映这些组件的状态：
立即学习“go语言免费学习笔记（深入）”；
func dbHealthCheck() bool {
// 模拟数据库连接检测
return true // 实际应调用 Ping()
}
func cacheHealthCheck() bool {
// 检查 Redis 是否可连
return true
}
func detailedHealthHandler(w http.ResponseWriter, r *http.Request) {
health := map[string]interface{}{
"status": "ok",
"checks": map[string]bool{
"database": dbHealthCheck(),
"redis": cacheHealthCheck(),
},
}
for _, ok := range health["checks"].(map[string]bool) {
if !ok {
w.WriteHeader(http.StatusServiceUnavailable)
health["status"] = "error"
break
}
}
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(health)
}
这样可以让运维人员快速定位问题模块。
3. 集成到 Gin 或其他 Web 框架
若使用 Gin，实现更简洁：
package main
import (
"github.com/gin-gonic/gin"
)
func main() {
r := gin.Default()
r.GET("/health", func(c *gin.Context) {
c.JSON(200, gin.H{
"status": "ok",
"service": "user-service",
})
})
r.Run(":8080")
}
4. 与 Kubernetes 和 Consul 配合
Kubernetes 通过 liveness 和 readiness 探针调用健康接口：
livenessProbe:
httpGet:
path: /health
port: 8080
initialDelaySeconds: 10
periodSeconds: 5
Consul 也可配置类似检查，自动剔除不健康实例。
基本上就这些。核心是提供一个稳定、轻量、能反映真实状态的接口，避免在健康检查中做耗时操作。简单有效最重要。
