docker config_error ai_generated true

错误：检测到循环依赖：service1 依赖于 service2，而 service2 又依赖于 service1

ERROR: Circular dependency detected: service1 depends on service2 which depends on service1

ID: docker/compose-service-dependency-cycle

其他格式: JSON · Markdown 中文 · English
95%修复率
90%置信度
1证据数
2023-11-01首次发现

版本兼容性

版本状态引入弃用备注
Docker Compose v2.0.0 active — — —
Docker Compose v2.20.0 active — — —
Docker Compose v2.24.0 active — — —

根因分析

在 docker-compose.yml 文件中，服务通过 'depends_on' 指令形成了循环依赖链，Docker Compose 无法解析。

English

In a docker-compose.yml file, services have a circular dependency chain via the 'depends_on' directive, which Docker Compose cannot resolve.

generic

官方文档

https://docs.docker.com/compose/compose-file/05-services/#depends_on

解决方案

  1. Redesign the service architecture to remove the circular dependency. For example, if service A needs service B and vice versa, consider merging them into a single service or using a message queue. Update docker-compose.yml to remove the cycle.
  2. Use 'depends_on' with 'condition: service_healthy' and implement health checks instead of direct dependencies. This allows services to start in any order but wait for readiness. Example: 'depends_on: { db: { condition: service_healthy } }'.

无效尝试

常见但无效的做法:

  1. 70% 失败

    Removing all depends_on directives breaks the intended startup order and may cause runtime failures if services depend on each other for readiness.

  2. 80% 失败

    Adding a third service that depends on both only masks the cycle temporarily; the underlying dependency graph remains invalid.