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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Cu depends_on: db: condition: service_healthy, Compose pornește db, apoi rulează periodic comanda din healthcheck a lui db și așteaptă rezultatul healthy. Dacă verificarea pică de retries ori la rând, containerul devine unhealthy, iar Compose renunță la serviciile dependente cu acest mesaj. Containerul db poate rula foarte bine; problema e că verificarea spune altceva.
Cele mai frecvente cauze: comanda din healthcheck nu există în imagine (curl în postgres sau în imaginile slim, deci codul 127 la fiecare verificare), comanda verifică ceva greșit (alt port, alt utilizator, un endpoint inexistent), timpii sunt prea mici pentru o aplicație care pornește greu (fără start_period) sau serviciul chiar are o problemă.
Varianta dependency failed to start: container magazin-db-1 exited (1) înseamnă că dependența s-a oprit de tot: atunci cauza e în docker compose logs db.
De ce apare: cauzele frecvente
1Unealta din healthcheck nu există în imagine
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:5432"] healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres"]Imaginea postgres nu are curl, iar Postgres nu vorbește HTTP. pg_isready e unealta oficială de verificare și există în imagine.
2Aplicația pornește mai încet decât permit verificările
healthcheck:
test: ["CMD", "wget", "-qO-", "http://localhost:3000/health"]
interval: 2s
retries: 2 healthcheck:
test: ["CMD", "wget", "-qO-", "http://localhost:3000/health"]
interval: 5s
retries: 5
start_period: 30sÎn start_period eșecurile nu se numără, deci aplicația are timp să pornească înainte să fie declarată unhealthy.
3Dependența se oprește (exited)
dependency failed to start: container magazin-db-1 exited (1)docker compose logs db
# de exemplu: lipsește POSTGRES_PASSWORDAici nu healthcheck-ul e problema, ci containerul care s-a oprit. Jurnalul spune de ce.
Repară eroarea, direct în pagină
În ~/magazin, docker compose up -d se oprește cu dependency failed to start: container magazin-db-1 is unhealthy, iar web nu pornește. Healthcheck-ul bazei folosește curl, care nu există în imaginea postgres. Înlocuiește verificarea cu pg_isready -U postgres (forma CMD-SHELL), pornește din nou proiectul și asigură-te că db e healthy și web rulează.
Indiciu
docker inspect --format '{{json .State.Health}}' magazin-db-1 arată de ce pică verificarea; noua linie: test: ["CMD-SHELL", "pg_isready -U postgres"].
Reparația
De ce pică verificarea:
docker inspect --format '{{json .State.Health}}' magazin-db-1În Log apare exec: "curl": executable file not found in $PATH. Înlocuiește verificarea:
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres"]
interval: 2s
retries: 3docker compose up -d
docker compose psmagazin-db-1 apare Up (healthy), iar magazin-web-1 rulează.
De ce merge
Healthcheck-ul rula curl în containerul postgres, unde nu există, deci fiecare verificare ieșea cu 127 și containerul devenea unhealthy, chiar dacă Postgres pornise corect. Cu pg_isready -U postgres, verificarea întreabă chiar serverul de baze de date dacă acceptă conexiuni, întoarce 0 după pornire, iar Compose pornește web abia când db e healthy.
Alte forme ale mesajului
dependency failed to start: container magazin-db-1 exited (1)dependency failed to start: container magazin-migrari-1 didn't complete successfully: exit 1container magazin-db-1 is unhealthy
Cum o eviți pe viitor
Testează comanda din healthcheck în container înainte s-o pui în compose.yaml: docker compose exec db pg_isready -U postgres și echo $? trebuie să dea 0. Folosește uneltele care există în imagine (pg_isready, redis-cli ping, wget în imaginile Alpine) sau un endpoint /health al aplicației. Setează start_period pentru aplicațiile care pornesc greu și urmărește starea cu docker compose ps (coloana STATUS arată healthy / unhealthy).
Întrebări frecvente
Cum văd de ce pică healthcheck-ul?
docker inspect --format '{{json .State.Health}}' magazin-db-1 afișează ultimele verificări, cu codul de ieșire și ieșirea fiecăreia (Log). Un cod 127 înseamnă că unealta nu există în imagine.
Containerul e unhealthy, dar aplicația merge. E grav?
Pentru Docker, nu e oprit; dar orice serviciu cu service_healthy nu va porni, iar orchestratoarele (Swarm, Kubernetes) pot reporni sau scoate din trafic un container nesănătos. Repară verificarea, ca starea să spună adevărul.
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ă. WARN[0000] The "DB_PAROLA" variable is not set. Defaulting to a blank string. compose.yaml folosește ${DB_PAROLA}, dar variabila nu există nici în shell, nici în fișierul .env de lângă compose.yaml, așa că Compose pune un șir gol. Adaugă DB_PAROLA=valoare în .env (în folderul proiectului) sau exportă variabila înainte de docker compose up. Error: Database is uninitialized and superuser password is not specified. Imaginea oficială postgres refuză să pornească fără parolă pentru utilizatorul postgres și se oprește cu Exited (1). Pornește containerul cu -e POSTGRES_PASSWORD=parola (în compose: environment: POSTGRES_PASSWORD). Î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.
