如何通过Docker的Healthcheck实现复杂业务探针，自动排除故障探针？

本文共计778个文字，预计阅读时间需要4分钟。

在Docker中使用HEALTHCHECK实现业务级探针，关键不在于复杂，而在于让检查命令真实反映业务可用性——例如数据库连接、缓存读写、下游依赖响应正常。单纯的端口号或进程存活检查远远不够，容易误报容器活着，服务已死的健康状态。

设计业务级健康检查命令

健康检查的核心是 CMD 后面那条命令，它必须能执行多步验证并统一返回退出码。推荐用 shell 脚本封装逻辑，避免单条 curl 或 telnet 的片面性。

• 把检查逻辑写进 ./health.sh 并 COPY 到镜像中，例如：
• 检查 HTTP 健康端点是否返回 200；
• 用 mysql -h db -u user -ppass -e "SELECT 1" 验证数据库可查询；
• 用 redis-cli -h redis PING 确认缓存服务响应；
• 任意一步失败就 exit 1，全部通过才 exit 0。

然后在 Dockerfile 中引用：

HEALTHCHECK --interval=20s --timeout=5s --start-period=60s --retries=3 \
CMD ["./health.sh"]

合理设置 start-period 和 timeout

业务服务启动慢很常见：Spring Boot 应用可能要 40 秒才完成初始化，依赖的 Redis 或 MySQL 也可能延迟就绪。