在 Docker Compose 运行异常全解析统计中，60% 的故障源于环境配置问题，而 depends_on 无效导致的连接拒绝是典型场景，只有在 Docker Compose v2.1+ 版本中结合 condition: service_healthy 才能从根本上解决服务就绪等待问题。

原因分析

depends_on 仅保证容器启动顺序，例如 Web 服务会在数据库容器启动后再启动，但不会判断数据库是否已完成初始化，这意味着即使容器运行，其内部服务可能仍在加载中，如 MySQL 容器可能已运行但数据库引擎仍在初始化，此时应用连接将失败。

解决方案

方案一：健康检查配合条件等待

在 Docker Compose v2.1+ 中，可使用 condition: service_healthy，例如为 postgres:15 配置 healthcheck，设置 interval: 5s，timeout: 5s，retries: 5，start_period: 10s，确保 web 服务等待 db 服务通过健康检查后才启动。

方案二：自定义等待脚本

通过脚本轮询依赖服务的健康状态，使用 nc -z $host $port 检测目标主机端口是否开放，成功后执行后续命令，脚本中常包含 sleep 2 进行轮询间隔控制。

注意事项

在分布式系统启动过程中，网络组件的初始化可能存在延迟，若服务 B 因网络模块加载缓慢延迟 10 秒才开放端口，而服务 A 在第 3 秒执行依赖探测，将判定 B 为宕机状态，此外 60% 的故障源于环境配置问题，需仔细检查。

参考来源

来源：Docker Compose 服务启动顺序难题 (depends_on 失效全解) - 2026 年 1 月 21 日发布

来源：Docker Compose 中的 depends_on 为何不生效？真相只有一个 - 截至 2025 年 11 月 29 日

来源：Docker Compose 运行异常全解析：从排查到修复的完整指南 - 发布时间是 2025 年 9 月 25 日