...
Eroare Docker · Docker Compose

dependency failed to start: container magazin-db-1 is unhealthy

Pe scurt

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

Greșit
BASH
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:5432"]
Corect
BASH
    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

Greșit
BASH
    healthcheck:
      test: ["CMD", "wget", "-qO-", "http://localhost:3000/health"]
      interval: 2s
      retries: 2
Corect
BASH
    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)

Greșit
BASH
dependency failed to start: container magazin-db-1 exited (1)
Corect
BASH
docker compose logs db
# de exemplu: lipsește POSTGRES_PASSWORD

Aici nu healthcheck-ul e problema, ci containerul care s-a oprit. Jurnalul spune de ce.

Repară tu

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"].

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 1
  • container 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

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