FATAL: database files are incompatible with server
Volumul conține o bază creată de altă versiune majoră de Postgres (de exemplu 15), iar containerul nou rulează 16, care nu o poate citi. Revino la imaginea veche (postgres:15) pe același volum, apoi fă migrarea corect: pg_dump din versiunea veche și restaurare într-un volum nou cu versiunea nouă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Formatul fișierelor de date Postgres se schimbă între versiunile majore (14, 15, 16...). Rândul DETAIL de după mesaj spune exact situația: The data directory was initialized by PostgreSQL version 15, which is not compatible with this version 16.6. Serverul refuză să pornească și containerul se oprește cu Exited (1).
În Docker apare când:
- folosești tag-ul
postgressaupostgres:latest, iar la undocker compose pulla venit o versiune majoră nouă; - ai schimbat
image: postgres:15înpostgres:16crezând că e un update simplu; - montezi volumul altui proiect, creat cu altă versiune.
Datele nu sunt stricate: versiunea veche le citește în continuare. Actualizarea între versiuni majore cere o migrare (pg_dump / pg_restore sau pg_upgrade), nu doar schimbarea imaginii. Versiunile minore (16.4 → 16.6) sunt compatibile.
De ce apare: cauzele frecvente
1Imaginea a sărit la altă versiune majoră
docker run -d --name db -e POSTGRES_PASSWORD=parola -v pgdata:/var/lib/postgresql/data postgres:16
# volumul a fost creat cu postgres:15docker run -d --name db -e POSTGRES_PASSWORD=parola -v pgdata:/var/lib/postgresql/data postgres:15Versiunea care a creat datele le poate citi, deci baza pornește ca înainte.
2Tag latest în compose.yaml
db:
image: postgresdb:
image: postgres:15Un tag cu versiunea majoră fixă nu se schimbă singur la pull.
3Migrare corectă la versiunea nouă
# schimbi doar imaginea pe același volumdocker exec db pg_dumpall -U postgres > backup.sql
docker run -d --name db16 -e POSTGRES_PASSWORD=parola -v pgdata16:/var/lib/postgresql/data postgres:16
docker exec -i db16 psql -U postgres < backup.sqlDatele exportate ca SQL se pot importa în orice versiune mai nouă, într-un volum nou.
Repară eroarea, direct în pagină
Volumul pgdata a fost creat de postgres:15. Cineva a recreat containerul db cu postgres:16 pe același volum, iar baza cade cu database files are incompatible with server. Recreează db cu versiunea care a creat datele, pe același volum pgdata, cu parola parola.
Indiciu
docker rm -f db, apoi același docker run cu postgres:15.
Reparația
docker rm -f db
docker run -d --name db -e POSTGRES_PASSWORD=parola \
-v pgdata:/var/lib/postgresql/data postgres:15De ce merge
Fișierele din pgdata sunt în formatul Postgres 15, pe care serverul 16 nu le poate citi fără migrare. Pornit din nou cu postgres:15, containerul găsește o bază în formatul lui, sare peste inițializare și pornește cu datele existente. Trecerea la 16 se face apoi separat: dump din 15, restaurare într-un volum nou cu 16.
Alte forme ale mesajului
DETAIL: The data directory was initialized by PostgreSQL version 15, which is not compatible with this version 16.6.FATAL: database files are incompatible with server DETAIL: The data directory was initialized by PostgreSQL version 13, which is not compatible with this version 17.2.
Cum o eviți pe viitor
Fixează mereu versiunea majoră a bazei de date în tag (postgres:16, mysql:8.4), niciodată latest. Planifică actualizările majore ca migrări: backup cu pg_dumpall, volum nou, versiunea nouă, restaurare, verificare, apoi ștergerea volumului vechi. Păstrează backup-ul până confirmi că aplicația merge pe versiunea nouă.
Întrebări frecvente
Mi-am pierdut datele?
Nu. Fișierele sunt intacte în volum. Pornește din nou cu versiunea care le-a creat (cea din DETAIL) și ai baza înapoi.
La MySQL e la fel?
MySQL poate face unele actualizări automat la pornire (de exemplu 8.0 → 8.4), dar trecerile mari sau înapoi la o versiune mai veche eșuează. Și acolo, backup-ul înainte de schimbarea imaginii e obligatoriu.
Erori înrudite
initdb: error: directory "/var/lib/postgresql/data" exists but is not empty Folderul de date al lui Postgres (montat de pe calculator sau dintr-un disc) conține deja fișiere care nu sunt o bază de date, de exemplu lost+found sau fișiere lăsate acolo. Montează un folder gol sau setează PGDATA la un subfolder: PGDATA=/var/lib/postgresql/data/pgdata. FATAL: password authentication failed for user "postgres" 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. Containerul se oprește imediat după pornire: Exited (1) Exited (1) înseamnă că aplicația din container a pornit și a crăpat cu o eroare. Citește motivul cu docker logs nume: de obicei e o cale greșită în CMD, un fișier sau un modul lipsă, o variabilă de mediu obligatorie nesetată sau o eroare în cod. Î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.
