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

UNIQUE constraint failed: clienti.email

Pe scurt

Î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

Greșit
SQL
INSERT INTO conturi_web (email, nume)
VALUES ('ion.popa@exemplu.ro', 'Ion Popa');
Corect
SQL
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

Greșit
SQL
UPDATE conturi_web
SET email = 'ana.vasile@posta.ro'
WHERE id = 3;
Corect
SQL
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ă

Greșit
SQL
INSERT INTO conturi_web (email, nume)
VALUES ('ana.vasile@posta.ro', 'Ana Maria Vasile');
Corect
SQL
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ă tu

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.

Codul care dă eroarea
SQL
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;
După reparație, programul afișează
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.

Alte forme ale mesajului

  • UNIQUE constraint failed: note.elev_id, note.materie
  • ERROR 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 și ana@x.ro să 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

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