...
Eroare Python · Baze de date cu sqlite3

sqlite3.IntegrityError: NOT NULL constraint failed: produse.nume

Pe scurt

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

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

Ce înseamnă

NOT NULL într-un CREATE TABLE înseamnă că acea coloană trebuie să aibă mereu o valoare. Mesajul NOT NULL constraint failed: produse.nume îți spune tabelul și coloana în care ar fi ajuns NULL.

În Python, None devine NULL când e trimis ca parametru. Așa că eroarea apare când o variabilă e None fără să-ți dai seama: dict.get("nume") pe o cheie lipsă, o funcție fără return, un câmp gol din formular convertit în None. Apare și când nu menționezi coloana în INSERT, iar ea nu are DEFAULT: valoarea implicită e NULL.

Afișează rândul pe care îl inserezi (print(params)) chiar înainte de execute și caută None. Dacă valoarea lipsă e normală, schema trebuie să permită NULL sau să aibă un DEFAULT.

De ce apare: cauzele frecvente

1Coloana obligatorie lipsește din INSERT

Greșit
PYTHON
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE produse (nume TEXT NOT NULL, pret REAL)")
conn.execute("INSERT INTO produse (pret) VALUES (12.5)")
Corect
PYTHON
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE produse (nume TEXT NOT NULL, pret REAL)")
conn.execute("INSERT INTO produse (nume, pret) VALUES ('pix', 12.5)")
print(conn.execute("SELECT * FROM produse").fetchall())

O coloană NOT NULL fără DEFAULT trebuie completată la fiecare inserare.

2None venit din dict.get()

Greșit
PYTHON
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE clienti (nume TEXT NOT NULL, email TEXT NOT NULL)")
rand = {"nume": "Ana"}
conn.execute("INSERT INTO clienti VALUES (?, ?)", (rand["nume"], rand.get("email")))
Corect
PYTHON
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE clienti (nume TEXT NOT NULL, email TEXT NOT NULL)")
rand = {"nume": "Ana"}
if rand.get("email"):
    conn.execute("INSERT INTO clienti VALUES (?, ?)", (rand["nume"], rand["email"]))
else:
    print("Rand sarit: lipseste emailul pentru", rand["nume"])

get întoarce None pentru cheia lipsă; validează datele înainte să le trimiți în bază.

3Coloană opțională fără DEFAULT

Greșit
PYTHON
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE stoc (produs TEXT NOT NULL, bucati INTEGER NOT NULL)")
conn.execute("INSERT INTO stoc (produs) VALUES ('caiet')")
Corect
PYTHON
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE stoc (produs TEXT NOT NULL, bucati INTEGER NOT NULL DEFAULT 0)")
conn.execute("INSERT INTO stoc (produs) VALUES ('caiet')")
print(conn.execute("SELECT * FROM stoc").fetchall())

Cu DEFAULT 0, coloana nemenționată primește 0, nu NULL.

Repară tu

Repară eroarea, direct în pagină

Programul înregistrează produse în stoc, dar al doilea produs nu are cantitate în date, iar inserarea dă sqlite3.IntegrityError: NOT NULL constraint failed: stoc.bucati. Modifică schema tabelului ca o cantitate lipsă să devină 0, apoi programul trebuie să afișeze caiet 10 și pix 0.

Codul care dă eroarea
PYTHON
import sqlite3

conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE stoc (produs TEXT NOT NULL, bucati INTEGER NOT NULL)")
intrari = [{"produs": "caiet", "bucati": 10}, {"produs": "pix"}]
for p in intrari:
    if "bucati" in p:
        conn.execute("INSERT INTO stoc (produs, bucati) VALUES (?, ?)", (p["produs"], p["bucati"]))
    else:
        conn.execute("INSERT INTO stoc (produs) VALUES (?)", (p["produs"],))
for produs, bucati in conn.execute("SELECT produs, bucati FROM stoc"):
    print(produs, bucati)
După reparație, programul afișează
caiet 10
pix 0
Indiciu

O coloană NOT NULL poate avea o valoare implicită, folosită când nu o completezi.

Alte forme ale mesajului

  • sqlite3.IntegrityError: NOT NULL constraint failed: clienti.email

Cum o eviți pe viitor

  • Validează datele înainte de INSERT: câmpurile obligatorii nu trebuie să fie None sau goale.
  • Pune DEFAULT pe coloanele care au o valoare firească (0, '', CURRENT_TIMESTAMP).
  • Numește coloanele în INSERT și verifică dacă le-ai inclus pe toate cele NOT NULL.
  • Folosește d["cheie"] în loc de d.get("cheie") pentru câmpuri obligatorii: lipsa lor dă KeyError imediat, mai ușor de înțeles.

Întrebări frecvente

Un text gol '' trece de NOT NULL?

Da. NOT NULL interzice doar NULL; un text gol e o valoare. Dacă vrei să interzici și textele goale, adaugă CHECK (nume <> '').

Pot scoate NOT NULL dintr-un tabel existent?

SQLite nu are ALTER COLUMN. Creezi un tabel nou cu schema dorită, copiezi datele (INSERT INTO nou SELECT ... FROM vechi), ștergi tabelul vechi și îl redenumești pe cel nou.

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.