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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine chiar de la serverul Postgres: conexiunea a ajuns la el, dar serverul e încă în faza de pornire (recuperare, citirea datelor sau, la prima rulare, inițializarea bazei și rularea scripturilor) și refuză temporar clienții. După câteva secunde, aceeași conexiune ar reuși.
În Docker apare tipic cu Compose: depends_on: - db (forma scurtă) așteaptă doar ca containerul db să fi pornit, nu ca Postgres să accepte conexiuni. Aplicația pornește imediat, încearcă să se conecteze, primește the database system is starting up și, dacă nu reîncearcă, se oprește cu eroare.
Ca să eviți asta, Compose trebuie să știe când baza e gata: healthcheck-ul cu pg_isready raportează healthy doar când serverul acceptă conexiuni, iar condition: service_healthy așteaptă exact acel moment.
De ce apare: cauzele frecvente
1depends_on în forma scurtă
api:
depends_on:
- dbapi:
depends_on:
db:
condition: service_healthyForma lungă cu service_healthy așteaptă ca healthcheck-ul bazei să treacă, nu doar pornirea containerului.
2Fără healthcheck pe bază
db:
image: postgres:16db:
image: postgres:16
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres"]
interval: 5s
retries: 5pg_isready răspunde cu succes doar când serverul acceptă conexiuni.
3Aplicația nu reîncearcă
pool = connect(DATABASE_URL)
# o singură încercare la pornirefor incercare in range(10):
try:
pool = connect(DATABASE_URL)
break
except OperationalError:
time.sleep(2)Reîncercările acoperă și repornirile bazei din timpul rulării, nu doar pornirea inițială.
Repară eroarea, direct în pagină
În ~/magazin, db (postgres:16) are deja un healthcheck cu pg_isready, dar serviciul api folosește depends_on: - db și pornește prea devreme, primind the database system is starting up. Fă ca api să aștepte ca db să fie sănătos și pornește proiectul.
Indiciu
Forma lungă: depends_on: → db: → condition: service_healthy.
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 -dDe ce merge
Forma scurtă - db aștepta doar ca containerul bazei să pornească, nu ca Postgres să accepte conexiuni. Cu condition: service_healthy, Compose pornește api abia după ce healthcheck-ul pg_isready al bazei trece, deci prima conexiune a aplicației găsește serverul gata. Fără reîncercări în cod, asta e protecția principală.
Alte forme ale mesajului
psql: error: connection to server at "db" (172.18.0.2), port 5432 failed: FATAL: the database system is starting uperror: the database system is starting upFATAL: the database system is shutting down
Cum o eviți pe viitor
În orice compose.yaml cu bază de date, pune healthcheck pe bază și condition: service_healthy la serviciile care se conectează la ea. Scrie și codul de conectare cu reîncercări, pentru că baza poate reporni și în timpul rulării. La prima pornire cu volum gol, inițializarea durează mai mult; ține cont de asta la retries și start_period.
Întrebări frecvente
De ce eroarea apare doar la prima pornire?
La prima rulare, imaginea inițializează baza și rulează scripturile din /docker-entrypoint-initdb.d, deci durează mai mult. La pornirile următoare, serverul e gata în una-două secunde și aplicația are noroc.
Ajunge un sleep 10 înainte de pornirea aplicației?
Merge uneori, dar e fragil: pe un calculator mai lent sau cu mai multe date, 10 secunde nu ajung. Healthcheck-ul așteaptă exact cât trebuie.
Erori înrudite
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. 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. psql: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: No such file or directory psql s-a conectat local, prin socket, într-un container în care nu rulează niciun server PostgreSQL. De obicei ai pornit un container nou (docker run postgres psql) în loc să intri în cel existent: folosește docker exec db psql -U postgres, sau dă -h cu numele containerului bazei. Î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.
