readinessProbe 不能只返回 HTTP 200,因 Kubernetes 不校验依赖状态;需在 handler 中检查 DB/Redis 等依赖、设超时、防 panic、避免 goroutine 泄漏,并合理配置 initialDelaySeconds 和 timeoutSeconds。

为什么 Kubernetes 的 readinessProbe 不能只返回 HTTP 200?
很多 Go 服务写个
http.HandleFunc("/healthz", func(w http.ResponseWriter, r *req) { w.WriteHeader(200) })</p>
<p>看似健康,但 Kubernetes 可能仍反复重启 Pod。根本原因是:readinessProbe 默认不校验响应体,也不检查依赖状态。Kubernetes 只管“能不能连上、有没有返回”,不管“数据库连没连上、队列是否积压、配置是否加载成功”。</p>
<p>实操建议:</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill12725" title="Kubernetes 301363"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20cf0281539.jpg" alt="Kubernetes 301363" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill12725" title="Kubernetes 301363">Kubernetes 301363</a>
<p>从抖音视频学习: Kubernetes — 【2026最新】这绝对是B站讲的最好的Kubernetes系统精讲教程,全程干货无废话!</p>
</div>
<a href="/xiazai/skill12725" title="Kubernetes 301363" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
<ul>
<li>必须在 handler 中主动检查关键依赖(如 DB 连接、Redis Ping、必要配置字段是否存在)</li>
<li>用 <code>context.WithTimeout 控制每个依赖检查不超过 1–2 秒,避免 probe 卡住导致 kubelet 认为容器失联
"db: dial timeout"),方便排查用 net/http 写 /healthz 时怎么避免 panic 和 goroutine 泄漏?
常见错误是直接在 handler 里调 db.Ping() 或 redis.Client.Ping(ctx),但没设 context 超时,或没 recover panic —— 一旦依赖挂掉,HTTP handler panic 会导致整个服务崩溃。
立即学习“go语言免费学习笔记(深入)”;
实操建议:
- 所有外部依赖调用都套
context.WithTimeout(r.Context(), 2*time.Second) - 用
defer func() { if r := recover(); r != nil { log.Printf("healthz panic: %v", r) } }()包住检查逻辑 - 不要在 health handler 中启动新 goroutine(比如 go doCheck()),kubelet 不等异步结果,且可能引发泄漏
要不要用第三方库比如 go-health?
可以,但得看场景。如果你的项目已经用 go.uber.org/zap + github.com/uber-go/ratelimit,再加一个 github.com/uber-go/health 增加维护成本;但如果你需要支持多检查项聚合、自动注册指标、或和 Prometheus 对接,它省事。
实操建议:
- 简单服务(单 DB + 单 Redis)直接手写 handler 更轻量、可控性高
- 如果用了
gRPC,注意go-health默认只支持 HTTP;要 gRPC health check,得自己实现health.Checker接口并注册到grpc.Server - 无论用不用库,最终暴露的 endpoint 路径必须和 YAML 里
readinessProbe.httpGet.path完全一致(比如是/healthz就不能写成/health)
Kubernetes 配置 readinessProbe 时哪些字段最容易配错?
最常被忽略的是 initialDelaySeconds 和 periodSeconds 的配合。Go 程序冷启动慢(尤其加载 config、建连接池),如果 initialDelaySeconds: 5 但程序实际要 8 秒才 ready,Pod 会被反复 kill restart。
实操建议:
-
initialDelaySeconds设为预估冷启动时间 + 2 秒(例如本地测出 main 启动到 HTTP server listen 耗时 6s,这里填 8) -
periodSeconds别设太小( 30),故障发现延迟高 -
failureThreshold建议保持默认 3,避免网络抖动误判;但若你用的是 headless Service + 自定义 DNS 发现,可酌情调高 - 务必加
timeoutSeconds: 2,否则 kubelet 默认等 1 秒,超时后直接断连,你的 handler 来不及写日志
复杂点在于:健康检查逻辑和业务启动顺序强耦合。比如 DB 连接池初始化完成前,/healthz 就该返回 503;而很多人把 DB 初始化放在 HTTP server 启动之后,导致 probe 总是先于依赖就绪 —— 这类时序问题,光看代码不容易发现,得靠启动日志打点验证。

















