健康检查是Docker Engine和Compose原生支持的机制,需在docker-compose.yml中被依赖服务(如db)定义healthcheck,test必须为数组格式,interval应设为响应时间2–3倍,timeout须小于interval,start_period需覆盖慢启动(如60s),状态变化不触发自动重启。

健康检查不是 Docker Desktop 的特有功能,而是 Docker Engine 和 Compose 规范原生支持的机制;Docker Desktop 只是运行时载体,配置方式和 Linux/macOS 原生 Docker 完全一致——关键在 docker-compose.yml 里写对 healthcheck,而不是在 Desktop UI 里点选。
healthcheck 必须写在被依赖的服务定义里
很多人误以为 healthcheck 是配在“要等别人”的服务上,其实正相反:它必须写在“被等待”的服务中(比如 db 或 redis),否则 depends_on: condition: service_healthy 根本没东西可查。
-
test字段必须是数组格式,例如["CMD", "curl", "-f", "http://localhost:8080/health"];写成字符串如test: "curl -f ..."会直接报错 - Alpine 镜像默认没
curl,得先装:apk add --no-cache curl,或改用["CMD-SHELL", "wget -qO- http://localhost:8080/health || exit 1"] - MySQL 示例中若用
mysqladmin ping,需确保容器内已安装mysql-client,且-h localhost不能省——127.0.0.1在某些网络模式下可能不通
interval / timeout / start_period 参数怎么设才不翻车
这三个值不是随便填的,默认 interval: 30s 对多数 Web 服务太慢,而 start_period: 0s(默认)会让 Spring Boot、PostgreSQL 这类启动慢的服务一上来就标 unhealthy。
-
interval应设为服务平均响应时间的 2–3 倍,比如接口通常 200ms 返回,设5s就够;太密会增加容器负载,太疏会延迟故障发现 -
timeout必须小于interval,否则两次检查会重叠;建议设为3–5s,足够覆盖网络抖动但不会卡死 -
start_period是最容易低估的:PostgreSQL 初始化可能耗 20–40s,Spring Boot 加载 JPA + Redis 连接池常需 30–90s,设60s比较稳妥
验证 healthcheck 是否真生效的三个命令
别光看 docker compose up 输出,得进容器内部或查状态才能确认逻辑跑通了。
- 启动后立刻执行
docker compose ps,观察 STATUS 列是否出现healthy(不是running)或unhealthy - 查详细健康记录:
docker inspect,重点看| jq '.State.Health' Status、FailingStreak和最近一次Output(比如curl: (7) Failed to connect to localhost port 8080: Connection refused) - 临时把
test改成一个必败命令(如["CMD", "false"]),再docker compose up -d,几秒后docker compose ps应该立刻变成unhealthy,否则说明配置根本没加载
最常被忽略的一点:健康状态变化本身不会触发容器重启,restart: on-failure 只响应进程退出码,不是 health 状态。如果想靠健康检查驱动恢复,得配合外部脚本或更高阶编排器(如 Kubernetes)——Docker Compose 本身只管“等”和“标状态”,不管“杀与拉”。











