绝大多数Golang服务应使用httpGet而非exec实现readinessProbe,因标准库或Gin可轻松暴露轻量HTTP端点(如/readyz),返回200即可;exec引入shell开销、权限及工具缺失风险,仅当需校验本地文件或socket等特殊场景才考虑,且更推荐在HTTP handler中等价实现。

就绪探针(readinessProbe)该用 HTTP 还是 exec?
绝大多数 Golang 服务用 httpGet 就够了,别一上来就写 exec。Golang 标准库的 http.ServeMux 或 gin.Engine 很容易暴露一个轻量级健康端点(比如 /healthz),返回 200 OK 即可。用 exec 调 curl 或自定义二进制,反而引入 shell 启动开销、权限问题和容器内工具缺失风险。
只有当你的服务依赖本地状态文件、锁文件或需校验进程外资源(如某 socket 是否 bind 成功)时,才考虑 exec;但此时更推荐在 HTTP handler 里做等价判断并统一返回。
-
httpGet必须配path和port,port可以是数字(8080)或命名端口(http),后者需在container.ports.name中明确定义 - 避免把
/当就绪路径——它可能触发完整业务逻辑(如 DB 查询、模板渲染),拖慢探针响应 - 不要在 handler 里调
os.Exit(1)或 panic:Kubernetes 只看 HTTP 状态码或 exec 退出码,panic 会 crash 容器,导致 liveness 也失败
initialDelaySeconds 和 periodSeconds 怎么设才不误伤?
就绪探针过早触发,会导致 Pod 被提前加入 Service Endpoints,但实际还没完成初始化(比如 DB 连接池没建好、配置没加载完),流量进来直接 500。常见错误是把 initialDelaySeconds 设成 1–3 秒——对 Golang 服务来说,这大概率不够。
你应该按真实冷启动耗时设:启动日志中从 main() 开始到 “server listening on :8080” 之间的时间,再加 2–3 秒 buffer。如果用了 viper 加载远程配置或连接 PostgreSQL,建议初始值 ≥ 10 秒。
立即学习“go语言免费学习笔记(深入)”;
-
periodSeconds默认 10 秒,对大多数 Golang 服务足够;高并发场景可缩至 5 秒,但别低于 3 秒——频繁请求健康端点可能干扰 pprof 或 metrics 暴露 -
failureThreshold建议保持默认 3,即连续 3 次失败才标记为 NotReady;设成 1 容易因网络抖动误判 - 不要把
timeoutSeconds设太高(如 30 秒):一次超时会阻塞整个探针周期,导致就绪状态更新滞后
HTTP 就绪端点该检查什么,不该检查什么?
就绪端点的核心任务是回答一个问题:“这个实例现在能不能安全收请求?” 它不是 liveness,不用验证长期存活能力;也不是完整集成测试,不该查下游所有依赖。
推荐分层检查:
- 必须检查:监听套接字是否 ready(
net.Listener.Addr()可访问)、本地 goroutine 管理器是否启动(如sync.WaitGroup初始化完成) - 建议检查:关键依赖连接池是否可用(如
db.PingContext(),带 1 秒 timeout)、必要配置项是否存在(如viper.Get("redis.addr") != nil) - 禁止检查:第三方 API(如调微信支付回调)、磁盘剩余空间、CPU 使用率——这些属于监控范畴,不该由就绪探针承担
示例 handler 片段(使用标准 net/http):
http.HandleFunc("/readyz", func(w http.ResponseWriter, r *http.Request) {
ctx, cancel := context.WithTimeout(r.Context(), time.Second)
defer cancel()
if err := db.PingContext(ctx); err != nil {
http.Error(w, "db unreachable", http.StatusServiceUnavailable)
return
}
w.WriteHeader(http.StatusOK)
})
就绪探针和 liveness 探针能共用一个端点吗?
技术上可以,但不推荐。共用端点会让就绪与存活语义混在一起,失去独立调控能力。比如 DB 临时不可用时,你希望 Pod 继续运行(liveness 正常),但暂时不接收新流量(readiness 失败)——如果共用端点,DB 故障会同时触发两者失败,Pod 被重启,反而放大故障。
更合理的做法是拆开:
-
/readyz:检查本地初始化 + 关键依赖连通性(如 DB、Redis) -
/livez:只检查进程是否卡死(如 goroutine 泄漏检测、http://localhost:6060/debug/health)或关键 channel 是否阻塞
如果实在想复用逻辑,至少通过 query 参数区分行为,例如 /healthz?probe=ready,并在 handler 里分支处理,避免配置耦合。
真正容易被忽略的是:就绪探针失败不会杀容器,但会从 EndpointSlice 中移除 IP;如果你的服务有 sticky session 或长连接,客户端可能还在往已 NotReady 的 Pod 发请求——这时得靠客户端重试 + Service 的 externalTrafficPolicy: Local 配合,或者用 Istio 的健康探测路由策略兜底。


















