ERROR: insert or update on table "comenzi" violates foreign key constraint "comenzi_client_id_fkey"
Rândul nou (sau modificat) trimite printr-o cheie străină la un rând care nu există în tabelul părinte, de exemplu o comandă pentru clientul 99. DETAIL arată valoarea lipsă. Creează întâi rândul părinte sau corectează valoarea cheii străine.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O cheie străină (REFERENCES clienti(id)) garantează că fiecare valoare din coloana copil există în tabelul părinte. La INSERT sau UPDATE în tabelul copil, PostgreSQL verifică existența, iar dacă lipsește, dă această eroare cu DETAIL: Key (client_id)=(99) is not present in table "clienti".
Cauze tipice: ordinea greșită a inserărilor (comanda înaintea clientului); un id greșit venit din aplicație; importuri în care tabelele copil se încarcă înaintea părinților; date de test cu id-uri inventate. Pentru importuri complexe, încarcă tabelele în ordinea dependențelor sau folosește constrângeri DEFERRABLE INITIALLY DEFERRED, verificate abia la COMMIT. Nu dezactiva cheile străine ca să „treacă” importul: datele orfane vor strica rapoartele mai târziu.
De ce apare: cauzele frecvente
1Ordinea inserărilor
INSERT INTO comenzi (client_id, data, total) VALUES (4, '2025-03-14', 99.00);
INSERT INTO clienti VALUES (4, 'Radu Stan', 'radu@exemplu.ro', NULL);INSERT INTO clienti VALUES (4, 'Radu Stan', 'radu@exemplu.ro', NULL);
INSERT INTO comenzi (client_id, data, total) VALUES (4, '2025-03-14', 99.00);Părintele trebuie să existe înaintea copilului.
2Id greșit
INSERT INTO comenzi (client_id, data, total) VALUES (99, current_date, 10);INSERT INTO comenzi (client_id, data, total)
SELECT id, current_date, 10 FROM clienti WHERE email = 'ana@exemplu.ro';Căutând clientul după o cheie naturală, nu inventezi id-uri.
3Import cu dependențe circulare
-- comenzi încărcate înaintea cliențilorALTER TABLE comenzi ALTER CONSTRAINT comenzi_client_id_fkey DEFERRABLE INITIALLY DEFERRED;
-- verificarea se face la COMMITCu o constrângere amânată, ordinea din tranzacție nu mai contează.
Repară eroarea, direct în pagină
Scriptul care înregistrează un client nou și prima lui comandă dă insert or update on table "comenzi" violates foreign key constraint "comenzi_client_id_fkey", pentru că inserează comanda înaintea clientului. Inversează ordinea și afișează numele clientului și totalul comenzii lui.
INSERT INTO comenzi (client_id, data, total) VALUES (4, '2025-03-14', 99.00);
INSERT INTO clienti VALUES (4, 'Radu Stan', 'radu@exemplu.ro', 'Brașov');
SELECT c.nume, co.total FROM comenzi co JOIN clienti c ON c.id = co.client_id WHERE c.id = 4;INSERT 0 1 INSERT 0 1 nume | total -----------+------- Radu Stan | 99.00 (1 rând)
Indiciu
Clientul trebuie să existe înainte de comandă.
Reparația
INSERT INTO clienti VALUES (4, 'Radu Stan', 'radu@exemplu.ro', 'Brașov');
INSERT INTO comenzi (client_id, data, total) VALUES (4, '2025-03-14', 99.00);
SELECT c.nume, co.total FROM comenzi co JOIN clienti c ON c.id = co.client_id WHERE c.id = 4;De ce merge
Cheia străină cere ca client_id 4 să existe în clienti în momentul inserării comenzii. Inserând întâi clientul, verificarea reușește, iar comanda se leagă de el. Interogarea finală face JOIN între cele două tabele și arată clientul Radu Stan cu comanda de 99.00 lei.
Alte forme ale mesajului
ERROR: insert or update on table "linii" violates foreign key constraint "linii_produs_id_fkey"
Cum o eviți pe viitor
- Inserează datele în ordinea dependențelor: părinți, apoi copii.
- În aplicație, obține id-urile din baza de date (
RETURNING id), nu le construi manual. - Pentru importuri mari sau circulare, folosește constrângeri amânabile în tranzacție.
- Tratează codul SQLSTATE
23503cu un mesaj clar pentru utilizator.
Întrebări frecvente
Cheia străină creează automat un index?
Nu pe coloana copil. PostgreSQL indexează doar coloanele referite (care au deja cheie primară sau UNIQUE). Indexul pe comenzi.client_id îl creezi tu, pentru JOIN-uri și ștergeri rapide.
NULL în coloana cheii străine e permis?
Da, dacă coloana nu e NOT NULL. Un NULL înseamnă „fără referință” și nu este verificat.
Erori înrudite
ERROR: update or delete on table "clienti" violates foreign key constraint "comenzi_client_id_fkey" on table "comenzi" Încerci să ștergi (sau să schimbi cheia) unui rând părinte care e încă referit din alt tabel, de exemplu un client care are comenzi. Cheia străină implicită (NO ACTION) interzice asta. Șterge sau mută întâi rândurile copil ori definește cheia cu ON DELETE CASCADE sau SET NULL, dacă asta e regula dorită. ERROR: there is no unique constraint matching given keys for referenced table "clienti" O cheie străină referă o coloană (sau un set de coloane) din tabelul părinte care nu are cheie primară sau constrângere UNIQUE. PostgreSQL cere ca valorile referite să fie unice. Adaugă UNIQUE pe coloana referită sau referă cheia primară a tabelului. ERROR: null value in column "email" of relation "clienti" violates not-null constraint Un INSERT sau UPDATE lasă fără valoare (NULL) o coloană declarată NOT NULL. De obicei coloana a fost omisă din lista INSERT și nu are DEFAULT, sau aplicația trimite NULL. Completează valoarea, adaugă un DEFAULT potrivit sau, dacă valoarea lipsă e legitimă, scoate constrângerea. Învață PostgreSQL de la zero, cu exerciții la fiecare lecție
Curs PostgreSQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
