...
Eroare Docker · Baze de date în containere

psql: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: FATAL: database "magazin" does not exist

Pe scurt

Serverul PostgreSQL rulează, dar baza magazin nu a fost creată. Imaginea o creează doar dacă pornește pe un volum gol cu POSTGRES_DB=magazin. Creeaz-o acum: docker exec db psql -U postgres -c 'CREATE DATABASE magazin', sau reinițializează volumul cu POSTGRES_DB.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

O instanță PostgreSQL conține mai multe baze de date. La prima pornire, imaginea oficială creează baza postgres și, opțional, încă una: cea din POSTGRES_DB (sau, dacă lipsește, una cu numele lui POSTGRES_USER). Când aplicația sau tu cereți -d magazin și baza nu există, serverul refuză conexiunea cu FATAL: database "magazin" does not exist.

Cauzele tipice:

  • containerul a fost pornit fără POSTGRES_DB;
  • ai adăugat POSTGRES_DB mai târziu, dar volumul era deja inițializat, deci variabila e ignorată (Skipping initialization în log);
  • numele diferă între aplicație (DATABASE_URL=.../magazin) și compose.yaml (POSTGRES_DB: shop);
  • litere mari: "Magazin" și magazin sunt baze diferite.

Listează bazele existente cu psql -U postgres -c '\l'.

De ce apare: cauzele frecvente

1Pornit fără POSTGRES_DB

Greșit
BASH
docker run -d --name db -e POSTGRES_PASSWORD=p postgres:16
docker exec db psql -U postgres -d magazin
Corect
BASH
docker exec db psql -U postgres -c 'CREATE DATABASE magazin'
docker exec db psql -U postgres -d magazin -c 'SELECT 1'

Baza se poate crea oricând cu CREATE DATABASE.

2POSTGRES_DB adăugat după inițializare

Greșit
BASH
# compose.yaml: adaugi POSTGRES_DB: magazin
docker compose up -d
Corect
BASH
docker compose exec db createdb -U postgres magazin

Volumul existent sare peste inițializare; creezi baza manual sau pornești cu volum nou.

3Nume diferit în aplicație

Greșit
BASH
POSTGRES_DB: shop
DATABASE_URL: postgres://postgres:p@db:5432/magazin
Corect
BASH
POSTGRES_DB: magazin
DATABASE_URL: postgres://postgres:p@db:5432/magazin

Aplicația trebuie să ceară exact baza creată.

Repară tu

Repară eroarea, direct în pagină

Containerul db (postgres:16) a fost pornit doar cu POSTGRES_PASSWORD, iar aplicația, care se conectează la baza magazin, primește FATAL: database "magazin" does not exist. Creează baza magazin în containerul existent, fără să-l recreezi, și verifică lista bazelor.

Indiciu

docker exec db psql -U postgres -c 'CREATE DATABASE magazin'.

Alte forme ale mesajului

  • FATAL: database "magazin" does not exist
  • connection to server at "db" (172.18.0.2), port 5432 failed: FATAL: database "magazin" does not exist
  • psql: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: FATAL: database "root" does not exist

Cum o eviți pe viitor

Pune POSTGRES_DB în compose.yaml de la prima pornire și folosește același nume în variabila de conexiune a aplicației, din .env. Pentru baze suplimentare, pune un script .sql în /docker-entrypoint-initdb.d. Ține minte că toate variabilele POSTGRES_* contează doar la inițializarea unui volum gol.

Întrebări frecvente

Pot crea baza din afara containerului?

Da, dacă portul e publicat: psql -h localhost -U postgres -c 'CREATE DATABASE magazin'. Din container e mai simplu: docker exec db createdb -U postgres magazin.

De ce uneori eroarea zice database "root"?

Când nu dai -d, psql folosește ca nume de bază numele utilizatorului. Cu -U root (sau fără -U, ca root), caută baza root.

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.