Go语言健康检查如何写_Go语言服务探活操作教程【收藏】-Golang-PHP中文网

go服务健康检查需解耦路由与状态逻辑，/health应检查核心依赖（如db、redis）是否在超时内可用，返回503而非500，区分liveness（进程存活）与readiness（业务就绪），避免假健康。

go语言健康检查如何写_go语言服务探活操作教程【收藏】

Go 服务的健康检查不需要框架也能写得稳，关键是把 /health 路由和状态判断逻辑解耦，避免误判“活着”的假象。

为什么 `http.HandleFunc("/health", ...)` 容易出问题

直接注册一个空 handler 响应 200 OK 是最常见也最危险的做法——它只说明 HTTP 服务进程没挂，但数据库连不上、缓存超时、磁盘写满时，照样返回健康。

真实场景中，/health 应该反映核心依赖是否可用，比如 db.PingContext()、redis.Ping() 是否在超时内成功
别在 handler 里做耗时操作（如查表、调远程 API），否则探活请求本身变成压测
Kubernetes 的 livenessProbe 默认超时 1 秒，超过就重启，而默认 http.Server.ReadTimeout 是 0（无限制）

用 `http.ServeMux` + `context.WithTimeout` 控制探活边界

健康检查必须有明确的超时和失败兜底，不能让一次慢查询拖垮整个探活链路。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

func healthHandler(db *sql.DB) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        ctx, cancel := context.WithTimeout(r.Context(), 800*time.Millisecond)
        defer cancel()

        err := db.PingContext(ctx)
        if err != nil {
            http.Error(w, "db unreachable", http.StatusServiceUnavailable)
            return
        }
        w.WriteHeader(http.StatusOK)
        w.Write([]byte("ok"))
    }
}

// 注册时带上依赖
mux := http.NewServeMux()
mux.HandleFunc("/health", healthHandler(db))

context.WithTimeout 必须基于 r.Context()，否则无法响应父级取消（如 K8s probe 中断）
错误要返回 http.StatusServiceUnavailable（503），不是 500；K8s 对 5xx 的处理策略不同，503 明确表示“暂时不可用”
不要用 log.Print 或 fmt.Println 打印健康日志——高频探活会刷爆日志，改用结构化日志并限流

`liveness` 和 `readiness` 别混在一起写

很多团队只留一个 /health，结果重启时新实例刚起来就立刻被流量打垮——因为还没加载完配置或预热缓存。

/live 只检查进程是否存活：能否响应 HTTP、goroutine 是否卡死（可加 runtime.NumGoroutine() > 10000 预警）
/ready 检查业务就绪：DB 连通、配置加载完成、本地缓存 warmup 完成、依赖服务返回正常
K8s 中两者 probe 设置应不同：livenessProbe.initialDelaySeconds: 10，readinessProbe.initialDelaySeconds: 3
别让 /ready 返回 JSON 包含太多字段——探活是机器读的，不是给人看的，ok 或 not_ready 就够