sqlite3.IntegrityError: UNIQUE constraint failed: utilizatori.email
Încerci să inserezi o valoare care există deja într-o coloană UNIQUE sau PRIMARY KEY (aici, același email). Verifică dacă rândul există, folosește INSERT OR IGNORE, sau actualizează rândul cu INSERT ... ON CONFLICT(email) DO UPDATE.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O constrângere UNIQUE (sau PRIMARY KEY) promite că o valoare apare o singură dată în coloană. UNIQUE constraint failed: utilizatori.email îți spune exact ce regulă ar fi fost încălcată: în tabelul utilizatori, coloana email are deja valoarea pe care vrei s-o inserezi. Pentru constrângeri pe mai multe coloane, mesajul le enumeră pe toate: UNIQUE constraint failed: note.elev, note.materie.
E o eroare bună: baza de date te protejează de duplicate. Problema e de obicei în logica programului: rulezi scriptul de populare de două ori, imporți același fișier din nou, nu verifici dacă utilizatorul există deja la înregistrare sau dai manual un id care e deja folosit.
Decide ce vrei să se întâmple la duplicat: să fie ignorat, să actualizeze rândul existent sau să afișeze un mesaj utilizatorului.
De ce apare: cauzele frecvente
1Scriptul de populare rulat de două ori
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE categorii (id INTEGER PRIMARY KEY, nume TEXT)")
for _ in range(2):
conn.execute("INSERT INTO categorii VALUES (1, 'Carti')")import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE categorii (id INTEGER PRIMARY KEY, nume TEXT)")
for _ in range(2):
conn.execute("INSERT OR IGNORE INTO categorii VALUES (1, 'Carti')")
print(conn.execute("SELECT COUNT(*) FROM categorii").fetchone()[0])INSERT OR IGNORE sare peste rândul care ar încălca constrângerea; aici mesajul era UNIQUE constraint failed: categorii.id.
2Vrei de fapt să actualizezi rândul
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE stoc (produs TEXT UNIQUE, bucati INTEGER)")
conn.execute("INSERT INTO stoc VALUES ('mere', 5)")
conn.execute("INSERT INTO stoc VALUES ('mere', 8)")import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE stoc (produs TEXT UNIQUE, bucati INTEGER)")
conn.execute("INSERT INTO stoc VALUES ('mere', 5)")
conn.execute("""INSERT INTO stoc VALUES ('mere', 8)
ON CONFLICT(produs) DO UPDATE SET bucati = excluded.bucati""")
print(conn.execute("SELECT bucati FROM stoc").fetchone()[0])ON CONFLICT ... DO UPDATE (upsert) actualizează rândul existent; excluded e rândul pe care voiai să-l inserezi.
3Înregistrare fără verificare
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE utilizatori (email TEXT UNIQUE)")
for email in ["ana@ex.ro", "ana@ex.ro"]:
conn.execute("INSERT INTO utilizatori VALUES (?)", (email,))import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE utilizatori (email TEXT UNIQUE)")
for email in ["ana@ex.ro", "ana@ex.ro"]:
try:
conn.execute("INSERT INTO utilizatori VALUES (?)", (email,))
except sqlite3.IntegrityError:
print("Exista deja un cont cu", email)Prinde IntegrityError și transformă-l într-un mesaj pentru utilizator.
Repară eroarea, direct în pagină
Programul importă abonații la newsletter dintr-o listă care are un email de două ori, iar al doilea INSERT dă sqlite3.IntegrityError: UNIQUE constraint failed: abonati.email. Repară inserarea ca duplicatele să fie ignorate în tăcere, iar programul să afișeze Abonati: 3.
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE abonati (email TEXT UNIQUE)")
emailuri = ["ana@ex.ro", "mihai@ex.ro", "ana@ex.ro", "ioana@ex.ro"]
for email in emailuri:
conn.execute("INSERT INTO abonati VALUES (?)", (email,))
print("Abonati:", conn.execute("SELECT COUNT(*) FROM abonati").fetchone()[0])Abonati: 3
Indiciu
SQLite are o formă de INSERT care sare peste rândurile care ar încălca o constrângere.
Reparația
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE abonati (email TEXT UNIQUE)")
emailuri = ["ana@ex.ro", "mihai@ex.ro", "ana@ex.ro", "ioana@ex.ro"]
for email in emailuri:
conn.execute("INSERT OR IGNORE INTO abonati VALUES (?)", (email,))
print("Abonati:", conn.execute("SELECT COUNT(*) FROM abonati").fetchone()[0])De ce merge
Coloana email e UNIQUE, deci al doilea ana@ex.ro ar fi încălcat constrângerea. INSERT OR IGNORE îi spune lui SQLite să sară peste rândurile care ar produce conflicte, fără eroare. Constrângerea își face treaba (nu apar duplicate), iar importul continuă: rămân 3 abonați unici.
Alte forme ale mesajului
sqlite3.IntegrityError: UNIQUE constraint failed: produse.idsqlite3.IntegrityError: UNIQUE constraint failed: note.elev, note.materie
Cum o eviți pe viitor
- Nu da manual valori pentru
INTEGER PRIMARY KEY; lasă SQLite să le genereze (INSERT INTO t (nume) VALUES (?)). - Scrie scripturile de populare idempotente:
INSERT OR IGNOREsau upsert, ca să le poți rula de mai multe ori. - La înregistrare, tratează
IntegrityErrorși afișează un mesaj clar („emailul e deja folosit”). - Normalizează valorile înainte (de exemplu
email.strip().lower()), ca să nu ai duplicate „ascunse” ce diferă doar prin litere mari.
Întrebări frecvente
Verific întâi cu SELECT sau prind excepția?
Prinderea excepției e mai sigură: între un SELECT și un INSERT, alt proces poate insera același rând. Constrângerea din baza de date e singura garanție reală.
De ce s-a anulat și restul tranzacției?
Instrucțiunea care a eșuat nu are efect, dar celelalte din tranzacție rămân în așteptare. Decide explicit: conn.rollback() ca să renunți la tot, sau continui și dai commit().
Erori înrudite
sqlite3.IntegrityError: NOT NULL constraint failed: produse.nume Încerci să salvezi NULL (None în Python) într-o coloană declarată NOT NULL: aici, produse.nume. Valoarea lipsește din INSERT, e None în date sau un câmp gol a fost transformat în None. Dă o valoare reală sau un DEFAULT. sqlite3.OperationalError: table produse has 3 columns but 2 values were supplied INSERT INTO produse VALUES (...) fără lista de coloane cere câte o valoare pentru fiecare coloană a tabelului. Ori dai toate valorile, ori (mai bine) numești coloanele pe care le completezi: INSERT INTO produse (nume, pret) VALUES (?, ?). KeyError: 'pret' Ceri dintr-un dicționar o cheie care nu există. Mesajul îți arată cheia căutată. Verifică scrierea exactă (litere mari, diacritice, spații), folosește `d.get(cheie, implicit)` dacă cheia poate lipsi sau verifică întâi cu `if cheie in d`. Învață Python de la zero, cu exerciții la fiecare lecție
Curs Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
