Docker Compose 依赖管理需组合使用 depends_on、healthcheck 和外部等待工具：depends_on 仅控制容器启动顺序；service_healthy 等待健康检查通过；wait-for-it.sh 用于端口探测；post_start 用于启动后初始化。
Docker Compose 本身不保证服务“真正就绪”，只控制容器进程的启动先后。要让服务按依赖关系可靠启动，得组合使用基础依赖、健康检查和外部等待机制。
用 depends_on 定义基础启动顺序
这是最直接的方式，告诉 Compose 哪些服务必须先启动。它按拓扑排序执行，确保依赖项容器已运行，但不等应用监听端口或完成初始化。
- 写法示例：
depends_on: [db, redis]或更明确地写成depends_on: db: condition: service_started - 适用于快速启动的服务（如 Nginx、Redis），或仅需容器进程存在即可继续的场景
- 注意：Docker Compose v2.20+ 默认启用
service_started，无需额外声明
用 healthcheck + condition: service_healthy 等待真正可用
当依赖服务需要完全初始化（比如 PostgreSQL 启动并接受连接），光靠容器启动不够，必须配健康检查，并让上游服务等待其状态变为 healthy。
- 数据库加健康检查：
healthcheck: test: ["CMD-SHELL", "pg_isready -U postgres"]，建议加上start_period: 30s给初始化留出时间 - 上游服务写法：
depends_on: db: condition: service_healthy - 该方式由 Docker 引擎原生支持，无需挂载脚本，适合生产环境
用 wait-for-it.sh 或类似工具主动探测端口
对不支持健康检查的老镜像，或需更灵活判断逻辑（比如 HTTP 返回 200、API 返回特定 JSON）时，可在应用容器内嵌入等待脚本。
- 把
wait-for-it.sh挂载进容器，修改启动命令：command: sh -c "./wait-for-it.sh db:5432 --timeout=60 -- npm start" - 支持链式等待：
./wait-for-it.sh db:5432 -- ./wait-for-it.sh redis:6379 -- npm start - 轻量、兼容性强，但会延长容器启动时间，且日志中可见轮询过程
补充：post_start 钩子用于启动后初始化
某些任务不适合放在主进程里（比如加载配置、预热缓存），可以用 post_start 在容器启动后立即执行一次性的命令。
- 示例：
post_start: - command: ["sh", "-c", "curl -X POST http://localhost:8000/health"] - 它不解决“等待依赖”问题，但可配合依赖服务就绪后触发自身准备动作
- 需注意：该功能在部分 Compose 版本中仍属实验性，建议确认
docker compose version支持情况
