Compose

ERROR: Circular dependency detected: service 'app' depends on 'worker' which depends on 'app'. – Docker COMPOSE_CIRCULAR_DEP

COMPOSE_CIRCULAR_DEP

Due o più servizi si referenziano a vicenda tramite la direttiva `depends_on`, generando un vicolo cieco ciclico che impedisce di determinare l'ordine sequenziale di avvio.

Categoria: DockerGruppo: ComposeConfidenza: altaUltimo aggiornamento: 19-08-2026Letto 1 volta

Cosa significa questo errore?

Due o più servizi si referenziano a vicenda tramite la direttiva `depends_on`, generando un vicolo cieco ciclico che impedisce di determinare l'ordine sequenziale di avvio.

Messaggio originale

ERROR: Circular dependency detected: service 'app' depends on 'worker' which depends on 'app'.

Contesto e parole chiave

Alias

  • Circular dependency detected compose
  • compose depends_on loop

Messaggi alternativi

  • dipendenza circolare rilevata tra servizi depends_on compose

Prodotti

  • Docker Engine / Docker Compose / BuildKit / containerd

Piattaforme

  • Docker Desktop su macOS
  • Docker Desktop su Windows
  • Linux

Parole chiave

  • Compose
  • COMPOSE_CIRCULAR_DEP
  • container
  • docker
  • docker.compose.circular-dependency-detected
  • errore-docker-compose-circular-dependency

Cause possibili

Origine del problema per Docker Compose: dipendenza circolare rilevata (depends_on loop)

Due o più servizi si referenziano a vicenda tramite la direttiva `depends_on`, generando un vicolo cieco ciclico che impedisce di determinare l'ordine sequenziale di avvio.

molto comune

Diagnosi

Diagnostica container e log per Docker Compose: dipendenza circolare rilevata (depends_on loop)

Eseguire comandi di ispezione dei container e controllare i log del demone Docker con journalctl o docker logs.

Come leggere il risultato. Mostra le eccezioni a runtime dell'applicazione, segnali di terminazione o errori di rete interna.

docker
docker logs --tail 50 <container_id>

Risoluzione

Procedura di risoluzione per Docker Compose: dipendenza circolare rilevata (depends_on loop)

Difficoltà: mediaRischio: basso

Applicare la configurazione raccomandata nelle specifiche ufficiali Docker e BuildKit.

  1. Ispezionare i parametri di avvio nel file Dockerfile o docker-compose.yml
  2. Verificare i vincoli di memoria, permessi e compatibilità delle porte
  3. Riavviare il container o eseguire una compilazione pulita senza cache

Domande frequenti

Come risolvere il problema COMPOSE_CIRCULAR_DEP in Docker?

Due o più servizi si referenziano a vicenda tramite la direttiva `depends_on`, generando un vicolo cieco ciclico che impedisce di determinare l'ordine sequenziale di avvio.

Approfondimenti

Schede correlate