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

FATAL: password authentication failed for user "postgres"

Pe scurt

Parola trimisă de aplicație nu e cea a bazei. În Docker, cauza tipică: ai schimbat POSTGRES_PASSWORD, dar volumul păstrează baza creată cu parola veche (variabila contează doar la prima inițializare). Folosește parola veche, schimb-o cu ALTER USER sau, pentru date de test, șterge volumul (docker compose down -v) și pornește din nou.

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

Ce înseamnă

Mesajul vine de la serverul PostgreSQL și apare în aplicație (psql: error: connection to server at "db" ... failed: FATAL: password authentication failed) sau în logurile containerului. Conexiunea a ajuns la server, deci rețeaua e în regulă; doar perechea utilizator + parolă nu se potrivește.

Capcana specifică Docker: POSTGRES_PASSWORD, POSTGRES_USER și POSTGRES_DB sunt citite doar la prima pornire, când folderul de date e gol și scriptul de inițializare creează baza. Dacă datele sunt într-un volum, la pornirile următoare logul spune Skipping initialization, iar parola nouă din compose.yaml e ignorată: baza o păstrează pe cea veche.

Alte cauze: parola din aplicație (DATABASE_URL) diferă de cea din serviciul db, caractere speciale nescăpate în URL (@, #), utilizator greșit.

De ce apare: cauzele frecvente

1Parola schimbată după inițializare

Greșit
BASH
# compose.yaml: POSTGRES_PASSWORD: veche -> nou
docker compose up -d
# baza păstrează parola veche din volum
Corect
BASH
docker compose down -v   # doar dacă datele nu contează
docker compose up -d

Cu volumul șters, baza se inițializează din nou, cu parola nouă.

2Vrei să păstrezi datele

Greșit
BASH
docker compose down -v
Corect
BASH
docker compose exec db psql -U postgres -c "ALTER USER postgres PASSWORD 'nou'"

Schimbi parola în baza existentă, fără să pierzi datele; apoi aplicația folosește parola nouă.

3Parolă diferită în aplicație

Greșit
BASH
environment:
  DATABASE_URL: postgres://postgres:parola@db:5432/magazin
Corect
BASH
environment:
  DATABASE_URL: postgres://postgres:${DB_PAROLA}@db:5432/magazin

Aceeași variabilă din .env ajunge și la db, și la aplicație.

Repară tu

Repară eroarea, direct în pagină

În ~/magazin, ai schimbat POSTGRES_PASSWORD din veche în nou și ai recreat containerul, dar aplicația primește password authentication failed: volumul pgdata păstrează baza creată cu parola veche (și tabela de test produse_test). Datele sunt doar de test: pornește baza de la zero, ca să se inițializeze cu parola nouă.

Indiciu

docker compose down -v șterge containerele și volumele proiectului; apoi docker compose up -d.

Alte forme ale mesajului

  • psql: error: connection to server at "db" (172.18.0.2), port 5432 failed: FATAL: password authentication failed for user "postgres"
  • error: password authentication failed for user "magazin"
  • PostgreSQL Database directory appears to contain a database; Skipping initialization

Cum o eviți pe viitor

Ține parola într-un singur loc (.env) și folosește-o atât la db, cât și la aplicație. Hotărăște parola înainte de prima pornire; pentru schimbări ulterioare, folosește ALTER USER. În dezvoltare, când schimbi configurarea de inițializare, pornește de la zero cu docker compose down -v.

Întrebări frecvente

De ce schimbarea din compose.yaml nu are efect?

Variabilele POSTGRES_* sunt folosite doar de scriptul de inițializare, care rulează când folderul de date e gol. Cu un volum existent, logul spune Skipping initialization, iar baza rămâne cum era.

Și la MySQL e la fel?

Da: MYSQL_ROOT_PASSWORD și celelalte se aplică doar la prima inițializare a volumului. După aceea, parola se schimbă cu ALTER USER sau ștergând volumul.

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.