...
Eroare SQL · Constrângeri: UNIQUE, NOT NULL, CHECK, chei străine

FOREIGN KEY constraint failed

Pe scurt

Rândul inserat sau modificat trimite la un rând părinte care nu există (de exemplu o carte cu autor_id = 9, dar nu există autorul 9), sau încerci să ștergi un părinte care mai are copii. Folosește un id existent, creează întâi părintele sau șterge întâi rândurile copil (ori declară ON DELETE CASCADE).

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

Ce înseamnă

O cheie străină (REFERENCES autori(id)) cere ca valoarea din coloana copil să existe în tabelul părinte. Mesajul FOREIGN KEY constraint failed apare când o instrucțiune ar strica această legătură. Spre deosebire de alte constrângeri, SQLite nu spune ce coloană sau ce valoare e problema, așa că trebuie s-o găsești tu.

Trei situații: un INSERT sau UPDATE în tabelul copil cu un id de părinte inexistent; un DELETE al unui părinte care mai are rânduri copil; un UPDATE al id-ului părintelui. În SQLite cheile străine sunt verificate doar dacă rulezi PRAGMA foreign_keys = ON; pe conexiune (în multe aplicații este oprit implicit).

Ca să găsești rândul problemă, verifică valoarea: SELECT * FROM autori WHERE id = 9; sau listează încălcările existente cu PRAGMA foreign_key_check;.

De ce apare: cauzele frecvente

1Copil cu un părinte inexistent

Greșit
SQL
INSERT INTO carti (titlu, autor_id)
VALUES ('Luceafărul', 9);
Corect
SQL
INSERT INTO carti (titlu, autor_id)
VALUES ('Luceafărul', 2);

Nu există autorul cu id 9. Cartea trebuie legată de un autor care există, aici Mihai Eminescu (id 2).

2Părintele e șters înaintea copiilor

Greșit
SQL
DELETE FROM autori WHERE id = 3;
Corect
SQL
DELETE FROM carti WHERE autor_id = 3;
DELETE FROM autori WHERE id = 3;

Autorul 3 are încă o carte. Ștergi întâi cărțile lui, apoi autorul. Alternativa este ON DELETE CASCADE în definiția cheii străine.

3Ordinea greșită la popularea tabelelor

Greșit
SQL
INSERT INTO carti (titlu, autor_id) VALUES ('Ion', 4);
INSERT INTO autori (id, nume) VALUES (4, 'Liviu Rebreanu');
Corect
SQL
INSERT INTO autori (id, nume) VALUES (4, 'Liviu Rebreanu');
INSERT INTO carti (titlu, autor_id) VALUES ('Ion', 4);

Părintele trebuie să existe înainte ca un copil să trimită la el.

Repară tu

Repară eroarea, direct în pagină

Cheile străine sunt active (PRAGMA foreign_keys = ON în setup). Scriptul trebuie să adauge autorul Liviu Rebreanu (id 4) și cartea „Ion” a lui, apoi să afișeze titlu și autor pentru toate cărțile, ordonate după id-ul cărții. Acum dă FOREIGN KEY constraint failed. Repară ordinea instrucțiunilor.

Codul care dă eroarea
SQL
INSERT INTO carti (titlu, autor_id) VALUES ('Ion', 4);
INSERT INTO autori (id, nume) VALUES (4, 'Liviu Rebreanu');

SELECT c.titlu, a.nume AS autor
FROM carti c
JOIN autori a ON a.id = c.autor_id
ORDER BY c.id;
După reparație, programul afișează
titlu | autor
Amintiri din copilărie | Ion Creangă
Poezii | Mihai Eminescu
Moara cu noroc | Ioan Slavici
Ion | Liviu Rebreanu
Indiciu

Autorul trebuie să existe înainte ca o carte să trimită la el.

Alte forme ale mesajului

  • foreign key mismatch - "carti" referencing "autori"
  • ERROR 1452 (23000): Cannot add or update a child row: a foreign key constraint fails
  • ERROR 1451 (23000): Cannot delete or update a parent row: a foreign key constraint fails
  • ERROR: insert or update on table "carti" violates foreign key constraint "carti_autor_id_fkey"
  • sqlite3.IntegrityError: FOREIGN KEY constraint failed

Cum o eviți pe viitor

  • Populează tabelele în ordinea părinte, apoi copil; șterge în ordine inversă.
  • Decide la crearea tabelului ce se întâmplă cu copiii la ștergerea părintelui: ON DELETE CASCADE (se șterg), ON DELETE SET NULL (rămân fără părinte) sau implicitul, care refuză ștergerea.
  • În SQLite, activează cheile străine pe fiecare conexiune cu PRAGMA foreign_keys = ON;, altfel nu se verifică deloc.
  • În aplicații, folosește id-urile întoarse de baza de date, nu valori scrise de mână.

Întrebări frecvente

De ce pe calculatorul meu nu primesc eroarea, iar pe server da?

În SQLite verificarea cheilor străine e oprită implicit și trebuie pornită cu PRAGMA foreign_keys = ON; pe fiecare conexiune. Dacă o aplicație o pornește și alta nu, aceleași date trec într-un loc și pică în altul.

Ce înseamnă foreign key mismatch?

E o eroare de schemă, nu de date: coloana referită din părinte nu este cheie primară sau UNIQUE. De exemplu REFERENCES autori(nume), unde nume nu e unic. Repari definiția tabelului.

Erori înrudite

← Toate erorile SQL

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ță SQL de la zero, cu exerciții la fiecare lecție

Curs SQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.