健康检查怎么写才不误报
健康检查要检查“服务能不能干活”,而不是“进程还在不在”。
容器在跑不等于服务可用。健康检查的价值是让编排层知道“现在能不能接流量”。
检查什么
- 进程存活:只能证明没退出;
- 端口监听:能证明进程绑定了端口;
- 业务就绪:能读写依赖、返回正确状态。
生产环境至少做到第三层,至少也要第二层。
yaml
healthcheck:
test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:8080/health || exit 1"]
interval: 30s
timeout: 5s
retries: 3
start_period: 40sstart_period 给应用启动留时间,避免刚启动就被判定失败。
别把依赖检查写成硬依赖
健康检查里连数据库,数据库抖动会让所有应用实例同时被判死,反而扩大故障。更好的做法是检查本地关键路径,把外部依赖放到单独的探针。
频率与超时
间隔太短会放大负载,太长会延迟发现。30 秒间隔、5 秒超时、3 次失败,是多数服务的合理起点。
健康检查不能有副作用
GET 请求里写数据、清理缓存、触发任务,会导致探活本身改变系统状态。检查接口必须是只读的。
与编排配合
depends_on: condition: service_healthy 依赖健康检查;没有健康检查时条件永远不成立。升级时也靠它判断新容器是否可用。
小结
检查业务、留启动时间、别查外部依赖、不要副作用。四点做到,健康检查才有意义。
说明:文中的地址、域名、主机名与账号均为脱敏示例;配置片段来自实际环境,但版本与网络条件不同,照搬前请先在测试环境验证。最后校对:2026-05-05。