容器与云原生 / 系统课时
depends_on 到底保证什么
depends_on 到底保证什么
depends_on 能表达服务之间的启动依赖,但“数据库容器已经启动”不等于“数据库已经能接受连接”。理解启动与就绪的区别,才能避免应用一启动就报连接失败,也能知道什么时候必须配合 healthcheck。
学习目标
- 说清短语法
depends_on实际保证的启动顺序。 - 使用
healthcheck与condition: service_healthy等待依赖真正就绪。 - 根据初始化任务、数据库和普通服务选择合适的依赖条件。
短语法只保证依赖先启动
短语法只列服务名,例如 app 依赖 db。Compose 会先创建并启动依赖服务,再启动下游服务;但它不会因为 db 进程还在执行初始化就自动等待到“可以接收业务请求”。官方 Compose 规范明确区分了 service_started 与 service_healthy。([Docker Documentation][3])

这也是为什么仅增加 depends_on: [db] 不能可靠修复启动竞争:它改变的是顺序,不是数据库内部初始化速度。
用 healthcheck 表达真正的就绪条件
下面用 Redis 演示完整配置。redis-cli ping 返回成功后,Redis 才会被标记为 healthy,app 的启动条件才满足。Compose 对标记为 service_healthy 的依赖会等待其健康检查通过。([Docker Documentation][4])
services:
cache:
image: redis:7.4-alpine
healthcheck:
test:
- CMD
- redis-cli
- ping
interval: 2s
timeout: 1s
retries: 10
start_period: 2s
app:
image: redis:7.4-alpine
depends_on:
cache:
condition: service_healthy
command:
- redis-cli
- -h
- cache
- ping在包含该 compose.yaml 的目录执行:
docker compose run --rm app 2>/dev/null预期输出
PONG如果健康检查一直失败,依赖条件就不会满足;此时应该修正健康检查或服务本身,而不是简单延长一个固定 sleep。健康检查应验证“下游真正需要的能力”,例如数据库能建立连接、HTTP 服务能返回可接受状态,而不只是进程存在。
三种 condition 对应三类依赖
| 条件 | 何时满足 | 典型场景 |
|---|---|---|
service_started |
依赖服务已启动 | 无需等待业务就绪的普通服务 |
service_healthy |
healthcheck 通过 |
数据库、缓存、HTTP API |
service_completed_successfully |
一次性依赖任务成功退出 | 数据迁移、初始化任务 |
service_started 与短语法语义相同;service_completed_successfully 则适合“先跑完一个任务,再启动应用”的链路。([Docker Documentation][3])
启动顺序不能替代运行时容错
即使启动阶段已经等到依赖健康,下游服务仍要处理依赖在运行过程中重启、断网或短暂不可用的情况。因此应用连接数据库、缓存或外部 API 时仍应有合理的超时与重试策略。
把 depends_on 看成“启动阶段的编排规则”更准确:短语法解决谁先启动,service_healthy 解决何时算就绪,而运行期间的故障恢复仍属于应用自身和容器运行策略的职责。