...
Eroare Python · Baze de date cu sqlite3

sqlite3.IntegrityError: UNIQUE constraint failed: utilizatori.email

Pe scurt

Î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

Greșit
PYTHON
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')")
Corect
PYTHON
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

Greșit
PYTHON
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)")
Corect
PYTHON
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

Greșit
PYTHON
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,))
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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])
După reparație, programul afișează
Abonati: 3
Indiciu

SQLite are o formă de INSERT care sare peste rândurile care ar încălca o constrângere.

Alte forme ale mesajului

  • sqlite3.IntegrityError: UNIQUE constraint failed: produse.id
  • sqlite3.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 IGNORE sau 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

← Toate erorile Python

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