Docker容器Running状态不等于健康，Healthcheck通过HEALTHCHECK指令或运行时参数主动验证服务可用性，依据命令退出码（0/1/2）判定状态，并支持动态覆盖与详细诊断。

Docker容器的Running状态不等于健康，Healthcheck是主动验证服务可用性的关键机制。

Healthcheck基础配置

在Dockerfile中通过HEALTHCHECK指令定义检查逻辑，Docker会定期执行命令并根据退出码判断状态：

• 0：healthy（健康）
• 1：unhealthy（异常）
• 2：reserved（保留，不能使用）

示例（检查Web服务是否响应200）：

HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
  CMD curl -f http://localhost:8080/health || exit 1

--interval控制检查频率，--start-period允许容器启动初期跳过失败判定，避免因服务未就绪误报。

运行时覆盖Healthcheck

构建镜像后仍可动态调整，适用于测试或临时调试：

• docker run时用--health-cmd、--health-interval等参数覆盖
• docker-compose.yml中在service下配置healthcheck:块，支持完整参数

注意：运行时覆盖不会修改镜像元数据，仅影响当前容器实例。

检查结果查看与诊断

容器健康状态直接体现在docker ps输出的STATUS列（如healthy、unhealthy、starting）：

• 用docker inspect 查看State.Health详细信息，含最近一次检查时间、退出码、输出日志
• 若检查失败，Output字段可能包含curl超时、连接拒绝等线索，便于定位是网络、端口还是应用内部问题

常见陷阱与建议

Healthcheck设计不当反而影响稳定性：

• 避免检查依赖外部服务（如远程数据库），否则将健康状态耦合到下游，违背“本容器自治”原则
• 不要用ps或pidof仅验证进程存在——进程在但HTTP服务卡死，检查仍会通过
• 对延迟敏感服务，适当缩短--timeout，防止检查本身阻塞调度
• 生产环境建议配合编排工具（如Swarm或K8s）的健康就绪探针联动，实现自动剔除和重启