...
Eroare Docker · Docker Compose

dependency failed to start: container magazin-db-1 has no healthcheck configured

Pe scurt

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

Greșit
BASH
db:
  image: postgres:16
api:
  depends_on:
    db:
      condition: service_healthy
Corect
BASH
db:
  image: postgres:16
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U postgres"]
    interval: 5s
    retries: 5
api:
  depends_on:
    db:
      condition: service_healthy

Cu healthcheck, containerul db trece în healthy, iar api pornește după aceea.

2Healthcheck pus la serviciul greșit

Greșit
BASH
api:
  healthcheck:
    test: ["CMD-SHELL", "pg_isready"]
  depends_on:
    db:
      condition: service_healthy
Corect
BASH
db:
  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

Greșit
BASH
depends_on:
  cache:
    condition: service_healthy
Corect
BASH
depends_on:
  cache:
    condition: service_started

service_started cere doar ca containerul să fi pornit, fără healthcheck.

Repară tu

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.

Alte forme ale mesajului

  • dependency failed to start: container magazin-cache-1 has no healthcheck configured
  • container 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

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