dependency failed to start: container magazin-db-1 has no healthcheck configured
Un serviciu are depends_on cu condition: service_healthy, dar serviciul de care depinde nu are healthcheck, deci Compose nu poate ști când e „sănătos”. Adaugă un healthcheck serviciului db (de exemplu pg_isready) sau schimbă condiția în service_started.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
depends_on cu condition: service_healthy înseamnă: pornește serviciul curent abia după ce dependența raportează starea healthy. Starea vine din healthcheck-ul containerului, definit în compose.yaml sau în imagine (HEALTHCHECK). Imaginile oficiale postgres, mysql, redis nu au healthcheck, deci containerul lor nu ajunge niciodată healthy, iar Compose renunță imediat cu has no healthcheck configured.
Mesajul numește containerul dependenței (magazin-db-1), nu serviciul care așteaptă. Serviciul care depinde rămâne Created, nepornit.
Reparația potrivită e aproape mereu un healthcheck pe dependență, care verifică dacă serverul chiar răspunde (pg_isready, mysqladmin ping, redis-cli ping). Așa aplicația pornește doar când baza acceptă conexiuni, nu doar când containerul ei a pornit.
De ce apare: cauzele frecvente
1service_healthy fără healthcheck
db:
image: postgres:16
api:
depends_on:
db:
condition: service_healthydb:
image: postgres:16
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres"]
interval: 5s
retries: 5
api:
depends_on:
db:
condition: service_healthyCu healthcheck, containerul db trece în healthy, iar api pornește după aceea.
2Healthcheck pus la serviciul greșit
api:
healthcheck:
test: ["CMD-SHELL", "pg_isready"]
depends_on:
db:
condition: service_healthydb:
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres"]Healthcheck-ul trebuie să fie pe serviciul așteptat, nu pe cel care așteaptă.
3Nu ai nevoie de sănătate, doar de ordine
depends_on:
cache:
condition: service_healthydepends_on:
cache:
condition: service_startedservice_started cere doar ca containerul să fi pornit, fără healthcheck.
Repară eroarea, direct în pagină
În ~/magazin, serviciul api așteaptă db cu condition: service_healthy, iar docker compose up -d dă container magazin-db-1 has no healthcheck configured. Adaugă serviciului db un healthcheck care verifică Postgres cu pg_isready -U postgres și pornește proiectul, cu ambele servicii pornite.
Indiciu
Sub db:: healthcheck: cu test: ["CMD-SHELL", "pg_isready -U postgres"], interval: 5s, retries: 5.
Reparația
services:
db:
image: postgres:16
environment:
POSTGRES_PASSWORD: parola
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres"]
interval: 5s
retries: 5
api:
image: node:20-alpine
command: sleep infinity
depends_on:
db:
condition: service_healthydocker compose up -d
docker compose psDe ce merge
Fără healthcheck, containerul db nu avea cum să devină healthy, deci condiția lui api nu putea fi îndeplinită niciodată. Cu pg_isready, Docker verifică la fiecare 5 secunde dacă Postgres acceptă conexiuni; după primul răspuns bun, db devine healthy, iar Compose pornește api.
Alte forme ale mesajului
dependency failed to start: container magazin-cache-1 has no healthcheck configuredcontainer magazin-db-1 has no healthcheck configured
Cum o eviți pe viitor
Când scrii condition: service_healthy, adaugă în același timp healthcheck-ul serviciului de care depinzi. Pentru bazele uzuale: pg_isready -U postgres (Postgres), mysqladmin ping -h localhost (MySQL), redis-cli ping (Redis). Verifică după pornire cu docker compose ps: coloana STATUS trebuie să arate (healthy).
Întrebări frecvente
Pot pune healthcheck-ul în Dockerfile în loc de compose.yaml?
Da, HEALTHCHECK din imagine e folosit și de Compose. Pentru imaginile oficiale de baze de date, pe care nu le construiești tu, îl pui în compose.yaml.
Ce se întâmplă dacă healthcheck-ul pică mereu?
Containerul ajunge unhealthy, iar Compose afișează dependency failed to start: container magazin-db-1 is unhealthy. Atunci verifici comanda din test cu docker exec.
Erori înrudite
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. 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ă. FATAL: the database system is starting up Aplicația s-a conectat la Postgres înainte ca acesta să termine pornirea (sau inițializarea la prima rulare). În Compose, adaugă bazei un healthcheck cu pg_isready și fă aplicația să aștepte cu depends_on: condition: service_healthy; în cod, adaugă reîncercări la conectare. Î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.
