...
Eroare Docker · Docker Compose

dependency cycle detected: web -> api -> web

Pe scurt

Î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

Greșit
BASH
web:
  depends_on: [api]
api:
  depends_on: [web]
Corect
BASH
web:
  depends_on: [api]
api:
  image: nginx

API-ul nu are nevoie de front-end ca să pornească; doar invers.

2Cerc prin mai multe servicii

Greșit
BASH
api:
  depends_on: [worker]
worker:
  depends_on: [db, api]
Corect
BASH
api:
  depends_on: [worker]
worker:
  depends_on: [db]

Fiecare dependență trebuie să coboare spre serviciile de bază, fără să se întoarcă.

Repară tu

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.

Alte forme ale mesajului

  • dependency cycle detected: api -> worker -> api
  • Circular 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

← Toate erorile Docker

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.