UNIQUE constraint failed: clienti.email
Încerci să inserezi sau să actualizezi un rând cu o valoare care există deja într-o coloană declarată UNIQUE (aici clienti.email). Baza de date refuză duplicatul. Folosește altă valoare, actualizează rândul existent sau tratează conflictul cu INSERT OR IGNORE ori ON CONFLICT.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O coloană cu constrângerea UNIQUE nu acceptă două rânduri cu aceeași valoare. Mesajul UNIQUE constraint failed: clienti.email îți spune exact tabelul și coloana: în clienti există deja un rând cu acel email.
Apare la INSERT (adaugi un client care există deja), la UPDATE (schimbi emailul unui client în emailul altuia) sau când rulezi de două ori același script de inserare. Dacă constrângerea e pe mai multe coloane, de exemplu UNIQUE (elev_id, materie), mesajul le enumeră pe toate: UNIQUE constraint failed: note.elev_id, note.materie.
Eroarea este de fapt o protecție. Reparația nu e să scoți constrângerea, ci să decizi ce vrei când valoarea există: să sari peste rând (INSERT OR IGNORE), să actualizezi rândul existent (ON CONFLICT ... DO UPDATE) sau să afișezi un mesaj utilizatorului.
De ce apare: cauzele frecvente
1Clientul există deja
INSERT INTO conturi_web (email, nume)
VALUES ('ion.popa@exemplu.ro', 'Ion Popa');INSERT OR IGNORE INTO conturi_web (email, nume)
VALUES ('ion.popa@exemplu.ro', 'Ion Popa');Cu OR IGNORE, rândul duplicat e sărit fără eroare, iar contul existent rămâne neschimbat.
2UPDATE care creează un duplicat
UPDATE conturi_web
SET email = 'ana.vasile@posta.ro'
WHERE id = 3;UPDATE conturi_web
SET email = 'laura.enache@posta.ro'
WHERE id = 3;Și UPDATE-ul trebuie să respecte constrângerea: emailul nou nu poate fi al altui cont.
3Vrei să actualizezi dacă există
INSERT INTO conturi_web (email, nume)
VALUES ('ana.vasile@posta.ro', 'Ana Maria Vasile');INSERT INTO conturi_web (email, nume)
VALUES ('ana.vasile@posta.ro', 'Ana Maria Vasile')
ON CONFLICT(email) DO UPDATE SET nume = excluded.nume;UPSERT-ul inserează un rând nou sau, dacă emailul există, actualizează numele din rândul existent. excluded înseamnă valorile pe care voiai să le inserezi.
Repară eroarea, direct în pagină
Scriptul importă o listă de trei conturi: unul nou (paul.nistor@mail.ro, Paul Nistor) și două care există deja în conturi_web. Acum se oprește cu UNIQUE constraint failed: conturi_web.email. Modifică inserarea astfel încât conturile existente să fie sărite, iar cel nou să fie adăugat; apoi se afișează email ordonat după id.
INSERT INTO conturi_web (email, nume) VALUES
('ion.popa@exemplu.ro', 'Ion Popa'),
('paul.nistor@mail.ro', 'Paul Nistor'),
('ana.vasile@posta.ro', 'Ana Vasile');
SELECT email FROM conturi_web ORDER BY id;email ana.vasile@posta.ro ion.popa@exemplu.ro laura.enache@exemplu.ro paul.nistor@mail.ro
Indiciu
INSERT OR IGNORE sare peste rândurile care încalcă o constrângere UNIQUE.
Reparația
INSERT OR IGNORE INTO conturi_web (email, nume) VALUES
('ion.popa@exemplu.ro', 'Ion Popa'),
('paul.nistor@mail.ro', 'Paul Nistor'),
('ana.vasile@posta.ro', 'Ana Vasile');
SELECT email FROM conturi_web ORDER BY id;De ce merge
Coloana email e declarată UNIQUE, deci al doilea rând cu același email e refuzat. Fără tratare, întreaga instrucțiune INSERT eșuează, inclusiv rândul nou.
Cu INSERT OR IGNORE, SQLite sare peste rândurile care încalcă constrângerea și le inserează pe celelalte. Paul Nistor primește id-ul 4, iar conturile existente rămân neschimbate. Dacă ai fi vrut să actualizezi numele existente, ai fi folosit ON CONFLICT(email) DO UPDATE.
Alte forme ale mesajului
UNIQUE constraint failed: note.elev_id, note.materieERROR 1062 (23000): Duplicate entry 'ion.popa@exemplu.ro' for key 'clienti.email'ERROR: duplicate key value violates unique constraint "clienti_email_key"sqlite3.IntegrityError: UNIQUE constraint failed: clienti.email
Cum o eviți pe viitor
- Decide de la început ce faci la duplicate: ignori, actualizezi sau afișezi o eroare prietenoasă.
- Nu verifica „există deja?” cu un SELECT înainte de INSERT: două cereri simultane trec amândouă de verificare. Lasă constrângerea să decidă și tratează eroarea.
- Normalizează valorile înainte de salvare (de exemplu emailurile cu litere mici, fără spații), ca
Ana@x.roșiana@x.rosă nu fie considerate diferite.
Întrebări frecvente
De ce primesc eroarea doar a doua oară când rulez scriptul?
Prima rulare a inserat rândurile. A doua încearcă să le insereze din nou, iar valorile unice există deja. Folosește INSERT OR IGNORE sau ON CONFLICT în scripturile care pot rula de mai multe ori.
UNIQUE permite mai multe valori NULL?
Da, în SQLite și PostgreSQL mai multe rânduri pot avea NULL într-o coloană UNIQUE, pentru că NULL nu e considerat egal cu NULL. Dacă vrei valoare obligatorie, adaugă și NOT NULL.
Erori înrudite
UNIQUE constraint failed: produse.id Inserezi un rând cu un id care există deja în tabel. Cheia primară e unică. Nu da id-ul la INSERT (lasă SQLite să-l genereze pentru INTEGER PRIMARY KEY) sau folosește un id liber; dacă vrei să înlocuiești rândul, folosește UPDATE sau ON CONFLICT. ON CONFLICT clause does not match any PRIMARY KEY or UNIQUE constraint Coloana din ON CONFLICT(coloana) nu are o constrângere PRIMARY KEY sau UNIQUE, deci SQLite nu are ce conflict să detecteze. Pune în ON CONFLICT coloana care chiar e unică (de obicei cheia primară) sau adaugă un index UNIQUE pe coloana dorită. NOT NULL constraint failed: produse.nume Coloana produse.nume este declarată NOT NULL, dar INSERT-ul sau UPDATE-ul îi lasă valoarea NULL: ai uitat coloana din listă sau ai trimis explicit NULL. Dă o valoare pentru coloană sau, dacă are sens, pune-i o valoare implicită cu DEFAULT. Î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.
