...
Eroare PostgreSQL · Constrângeri, chei și secvențe

ERROR: insert or update on table "comenzi" violates foreign key constraint "comenzi_client_id_fkey"

Pe scurt

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

Greșit
SQL
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);
Corect
SQL
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

Greșit
SQL
INSERT INTO comenzi (client_id, data, total) VALUES (99, current_date, 10);
Corect
SQL
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

Greșit
SQL
-- comenzi încărcate înaintea clienților
Corect
SQL
ALTER TABLE comenzi ALTER CONSTRAINT comenzi_client_id_fkey DEFERRABLE INITIALLY DEFERRED;
-- verificarea se face la COMMIT

Cu o constrângere amânată, ordinea din tranzacție nu mai contează.

Repară tu

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.

Codul care dă eroarea
SQL
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;
După reparație, programul afișează
INSERT 0 1
INSERT 0 1
   nume    | total
-----------+-------
 Radu Stan | 99.00
(1 rând)
Indiciu

Clientul trebuie să existe înainte de comandă.

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 23503 cu 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

← Toate erorile PostgreSQL

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ță 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.