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.
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
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)")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()
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")))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
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')")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ă 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.
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)caiet 10 pix 0
Indiciu
O coloană NOT NULL poate avea o valoare implicită, folosită când nu o completezi.
Reparația
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE stoc (produs TEXT NOT NULL, bucati INTEGER NOT NULL DEFAULT 0)")
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)De ce merge
Când inserezi doar produs, SQLite pune în bucati valoarea implicită a coloanei. Fără DEFAULT, aceea era NULL, interzisă de NOT NULL. Cu DEFAULT 0, pixul primește automat 0 bucăți, iar constrângerea e respectată. Coloana rămâne protejată: un None trimis explicit tot ar fi respins.
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ă fieNonesau goale. - Pune
DEFAULTpe coloanele care au o valoare firească (0,'',CURRENT_TIMESTAMP). - Numește coloanele în
INSERTși verifică dacă le-ai inclus pe toate celeNOT NULL. - Folosește
d["cheie"]în loc ded.get("cheie")pentru câmpuri obligatorii: lipsa lor dăKeyErrorimediat, 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
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. 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 (?, ?). AttributeError: 'NoneType' object has no attribute 'append' Apelezi o metodă (append, split, get, upper...) pe o variabilă care e `None`. De obicei ai salvat rezultatul unei metode care modifică pe loc (`lista = lista.append(x)`) sau al unei funcții fără `return`. Nu salva rezultatul lui `append`/`sort` și verifică ce întorc funcțiile tale. Î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.
