Go服务探针失败主因是程序未按K8s节奏暴露端点:/health等路径常被框架中间件或依赖阻塞,应绕过框架用原生http.ServeMux独立暴露轻量级探针,gRPC服务须用grpc_health_v1并声明appProtocol: grpc。

Go 服务的 readinessProbe 或 livenessProbe 失败,90% 不是探针配错了,而是 Go 程序没按 Kubernetes 的节奏暴露可探测端点。
为什么 /health 返回 503 或超时
很多 Go 服务直接复用主 HTTP 路由(比如 Gin 的 r.GET("/health", handler))响应探针,但这个 handler 往往依赖中间件(JWT 验证、日志、panic 恢复)、DB 连接或下游 gRPC 调用。一旦 DB 暂不可达,/health 就返回 503,Kubernetes 立刻把 Pod 标为 NotReady——哪怕 HTTP server 本身完全正常。
- 必须用原生
http.ServeMux或独立http.Server暴露探针,绕过所有框架中间件链 - 就绪探针(readiness)只检查 listener 是否已启动,不查任何外部依赖;存活探针(liveness)可加轻量级内存/CPU 自检,但绝不查 DB
- 路径别硬写
/health:Gin 默认不注册该路由,Echo 默认是/healthz,Kubernetes 不会自动适配
gRPC 服务不能用 HTTP 探针硬套
用 grpc_health_v1 实现 Health Check 是唯一合规方式。HTTP probe 对 gRPC 端口发 GET 请求,必然连接拒绝或 TLS 握手失败,readinessProbe 持续报 connection refused。
- 代码里必须注册
grpc_health_v1.NewHealthServer(),并绑定到 gRPC Server - Kubernetes Service YAML 中必须显式声明
appProtocol: grpc,否则 kube-proxy 不识别协议语义 - probe 配置要改用
grpc类型:exec: ["grpc_health_probe", "-addr=:8080"],而非httpGet
探针参数和 Go 启动节奏对不上
Go 启动快,但初始化 DB 连接池、加载配置、建立 gRPC client 可能耗时数秒。probe 在容器刚启动就发起请求,此时 http.Server 已 listen,但 handler 还没 ready,结果返回 200 却无真实服务能力。
-
initialDelaySeconds必须 ≥ 应用冷启动最长时间(比如 30s),不能凭感觉设 5s -
failureThreshold别设太低:StartupProbe 默认 3 次失败就杀容器,但 Go 初始化可能刚好卡在第 3 次探测前 - Go 代码里别用
http.ListenAndServe()隐式阻塞;改用srv.ListenAndServe()并配合sync.WaitGroup或 channel 通知“真正就绪”
ConfigMap/Secret 注入失败导致探针路径 404
探针路径写的是 /readyz,但 Go 代码里实际注册的是 /status,这种不一致往往源于环境变量注入失败后,程序 fallback 到默认路径,而你根本没察觉。
- ConfigMap key 含短横线(如
health-path)会被 Kubernetes 静默跳过,os.Getenv("HEALTH_PATH")返回空字符串 - 务必用
kubectl exec -it确认最终生效的值-- env | grep HEALTH - Go 启动时应校验关键路径是否为空:
if path := os.Getenv("READY_PATH"); path == "" { log.Fatal("missing READY_PATH") }
最常被忽略的点:probe 失败不是孤立事件,它几乎总和资源限制、二进制构建、gRPC 声明三者之一交叉发生。比如 memory requests 设太低引发 GC 风暴,导致 HTTP server 响应延迟超 probe timeout——这时调高 timeoutSeconds 只是掩耳盗铃,得先看 kubectl top pod 和 GC 日志。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











