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

FATAL: database files are incompatible with server

Pe scurt

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 postgres sau postgres:latest, iar la un docker compose pull a venit o versiune majoră nouă;
  • ai schimbat image: postgres:15 în postgres:16 crezâ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ă

Greșit
BASH
docker run -d --name db -e POSTGRES_PASSWORD=parola -v pgdata:/var/lib/postgresql/data postgres:16
# volumul a fost creat cu postgres:15
Corect
BASH
docker run -d --name db -e POSTGRES_PASSWORD=parola -v pgdata:/var/lib/postgresql/data postgres:15

Versiunea care a creat datele le poate citi, deci baza pornește ca înainte.

2Tag latest în compose.yaml

Greșit
BASH
db:
  image: postgres
Corect
BASH
db:
  image: postgres:15

Un tag cu versiunea majoră fixă nu se schimbă singur la pull.

3Migrare corectă la versiunea nouă

Greșit
BASH
# schimbi doar imaginea pe același volum
Corect
BASH
docker 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.sql

Datele exportate ca SQL se pot importa în orice versiune mai nouă, într-un volum nou.

Repară tu

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.

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

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