dependency cycle detected: web -> api -> web
În compose.yaml, serviciile depind unele de altele în cerc (web depinde de api, iar api de web), deci Compose nu are cu ce să înceapă. Păstrează depends_on doar în direcția reală: cel care folosește un serviciu depinde de el, nu și invers. Scoate dependența în plus.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
depends_on stabilește ordinea de pornire: un serviciu pornește după cele de care depinde. Compose construiește din ele un graf și caută ordinea. Dacă graful are un cerc, nu există o ordine posibilă, iar Compose se oprește și îți arată cercul complet: web -> api -> web.
Cercul apare de obicei din copy-paste (un bloc de serviciu copiat cu tot cu depends_on), din confuzia despre direcție (pui depends_on la ambele servicii „ca să se vadă”) sau prin servicii intermediare (web -> api -> worker -> web).
Regula: dependența merge de la cel care folosește la cel folosit. Front-end-ul depinde de API, API-ul de bază de date. Baza de date nu depinde de nimeni. Pentru ca două servicii să comunice nu e nevoie de depends_on: rețeaua comună a proiectului le leagă oricum.
De ce apare: cauzele frecvente
1Dependență în ambele sensuri
web:
depends_on: [api]
api:
depends_on: [web]web:
depends_on: [api]
api:
image: nginxAPI-ul nu are nevoie de front-end ca să pornească; doar invers.
2Cerc prin mai multe servicii
api:
depends_on: [worker]
worker:
depends_on: [db, api]api:
depends_on: [worker]
worker:
depends_on: [db]Fiecare dependență trebuie să coboare spre serviciile de bază, fără să se întoarcă.
Repară eroarea, direct în pagină
În ~/magazin, docker compose up -d se oprește cu dependency cycle detected: web -> api -> web. Front-end-ul web folosește API-ul api, dar API-ul nu are nevoie de front-end. Repară compose.yaml ca dependența să meargă doar de la web la api și pornește proiectul.
Indiciu
Șterge depends_on de la serviciul api.
Reparația
services:
web:
image: nginx:1.27-alpine
ports:
- "8080:80"
depends_on:
- api
api:
image: nginx:1.27-alpinedocker compose up -d
docker compose psDe ce merge
Cu depends_on la ambele servicii, Compose nu găsea un serviciu care să pornească primul. Fără dependența lui api de web, ordinea devine clară: întâi api, apoi web. Proiectul pornește, iar cele două servicii comunică în continuare prin rețeaua magazin_default, fără să aibă nevoie de depends_on în ambele sensuri.
Alte forme ale mesajului
dependency cycle detected: api -> worker -> apiCircular dependency between web and api
Cum o eviți pe viitor
Desenează (sau imaginează) serviciile pe niveluri: baze de date și cache jos, API-uri la mijloc, front-end și proxy sus. depends_on arată mereu în jos. Rulează docker compose config după fiecare modificare a dependențelor: verifică fișierul fără să pornească nimic. Nu folosi depends_on doar ca să conectezi serviciile între ele.
Întrebări frecvente
Dacă scot depends_on, mai pot vorbi serviciile între ele?
Da. Toate serviciile din proiect sunt în aceeași rețea, proiect_default, și se găsesc după nume. depends_on controlează doar ordinea de pornire.
Două servicii chiar au nevoie unul de altul. Ce fac?
Lasă depends_on într-o singură direcție și fă aplicațiile să reîncerce conexiunea la pornire (retry). Așa nu contează care pornește primul.
Erori înrudite
service "web" depends on undefined service "baza": invalid compose project În compose.yaml, depends_on (sau links) al serviciului web pomenește un serviciu care nu există în fișier. Pune la depends_on exact numele unei chei de sub services (aici db), sau adaugă serviciul lipsă. dependency failed to start: container magazin-db-1 is unhealthy Un serviciu are depends_on cu condition: service_healthy, iar healthcheck-ul dependenței (aici db) pică, deci Compose nu pornește serviciul care așteaptă. Citește motivul cu docker inspect magazin-db-1 (State.Health.Log) și repară comanda din healthcheck sau serviciul în sine. yaml: line 4: mapping values are not allowed in this context compose.yaml are o greșeală de sintaxă YAML în jurul liniei 4, aproape mereu de indentare: o cheie mutată cu un spațiu, un Tab în loc de spații sau lipsa spațiului după două puncte. Aliniază cheile de același nivel exact la aceeași coloană, doar cu spații. Învață Docker de la zero, cu exerciții la fiecare lecție
Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
