NOT NULL constraint failed: produse.nume
Coloana produse.nume este declarată NOT NULL, dar INSERT-ul sau UPDATE-ul îi lasă valoarea NULL: ai uitat coloana din listă sau ai trimis explicit NULL. Dă o valoare pentru coloană sau, dacă are sens, pune-i o valoare implicită cu DEFAULT.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
NOT NULL înseamnă că o coloană trebuie să aibă mereu o valoare. Mesajul NOT NULL constraint failed: produse.nume spune că rândul pe care încerci să-l salvezi ar avea NULL în produse.nume.
Cauzele tipice: lista de coloane din INSERT nu conține coloana obligatorie (iar coloana nu are DEFAULT), valoarea trimisă din aplicație e None/null pentru că un câmp din formular a rămas gol, sau un UPDATE pune NULL (direct ori dintr-o subinterogare care nu găsește nimic).
Atenție: dacă o coloană are DEFAULT, valoarea implicită se folosește doar când omiți coloana din INSERT. Dacă trimiți explicit NULL, valoarea implicită nu se aplică și primești tot această eroare.
De ce apare: cauzele frecvente
1Coloana obligatorie lipsește din INSERT
INSERT INTO produse (categorie, pret, stoc)
VALUES ('Iluminat', 89, 15);INSERT INTO produse (nume, categorie, pret, stoc)
VALUES ('Bandă LED', 'Iluminat', 89, 15);nume nu are valoare implicită, deci trebuie dat la fiecare inserare.
2NULL trimis explicit
INSERT INTO produse (nume, categorie, pret)
VALUES (NULL, 'Mobilă', 450);INSERT INTO produse (nume, categorie, pret)
VALUES ('Comodă', 'Mobilă', 450);În aplicații, valoarea vine de obicei dintr-un câmp lăsat gol. Validează datele înainte de inserare.
3UPDATE din subinterogare fără rezultat
UPDATE produse
SET nume = (SELECT nume FROM produse_noi WHERE cod = 'X-1')
WHERE id = 2;UPDATE produse
SET nume = COALESCE((SELECT nume FROM produse_noi WHERE cod = 'X-1'), nume)
WHERE id = 2;Dacă subinterogarea nu găsește niciun rând, întoarce NULL. COALESCE păstrează valoarea veche în acest caz.
Repară eroarea, direct în pagină
Scriptul adaugă produsul „Bandă LED” (Iluminat, 89 lei, stoc 15) și afișează apoi produsele din Iluminat (nume, pret), ordonate după preț. Acum dă eroarea NOT NULL constraint failed: produse.nume. Repară inserarea.
INSERT INTO produse (categorie, pret, stoc)
VALUES ('Iluminat', 89, 15);
SELECT nume, pret
FROM produse
WHERE categorie = 'Iluminat'
ORDER BY pret;nume | pret Bec inteligent | 65.5 Bandă LED | 89 Lampă LED | 120
Indiciu
Coloana nume este obligatorie, dar lipsește din lista de coloane.
Reparația
INSERT INTO produse (nume, categorie, pret, stoc)
VALUES ('Bandă LED', 'Iluminat', 89, 15);
SELECT nume, pret
FROM produse
WHERE categorie = 'Iluminat'
ORDER BY pret;De ce merge
Coloana nume este declarată NOT NULL și nu are valoare implicită. Când lipsește din lista de coloane, SQLite ar pune NULL în ea, iar constrângerea refuză rândul.
Cu nume în listă și valoarea 'Bandă LED', produsul se inserează și apare între becul inteligent și lampa LED, în ordinea prețului.
Alte forme ale mesajului
NOT NULL constraint failed: clienti.numeERROR 1048 (23000): Column 'nume' cannot be nullERROR 1364 (HY000): Field 'nume' doesn't have a default valueERROR: null value in column "nume" of relation "produse" violates not-null constraintsqlite3.IntegrityError: NOT NULL constraint failed: produse.nume
Cum o eviți pe viitor
- Scrie mereu lista de coloane la
INSERTși verifică dacă ai inclus toate coloaneleNOT NULLfărăDEFAULT. - Pentru coloanele care au o valoare firească (status, data creării, cantitate 0), definește
DEFAULTla crearea tabelului. - În aplicație validează câmpurile obligatorii înainte de a trimite interogarea și afișează un mesaj clar utilizatorului.
- Uită-te la structură cu
PRAGMA table_info(produse);: coloananotnullarată care coloane sunt obligatorii.
Întrebări frecvente
Am pus DEFAULT, de ce primesc tot eroarea?
Pentru că trimiți explicit NULL. DEFAULT se aplică doar când coloana lipsește din INSERT. Scoate coloana din listă sau folosește COALESCE(valoare, 'implicit').
Șirul gol '' încalcă NOT NULL?
Nu. Un text gol este o valoare, nu NULL. Dacă vrei să refuzi și textele goale, adaugă o constrângere CHECK (nume <> '') sau CHECK (length(trim(nume)) > 0).
Erori înrudite
CHECK constraint failed: pret >= 0 Valoarea pe care o inserezi sau o actualizezi încalcă o regulă CHECK din definiția tabelului (aici pret >= 0). Mesajul arată regula sau numele constrângerii. Corectează valoarea; schimbă regula doar dacă ea e cea greșită. Cannot add a NOT NULL column with default value NULL ALTER TABLE ... ADD COLUMN cu NOT NULL, dar fără DEFAULT: rândurile existente ar primi NULL, ceea ce încalcă regula. Adaugă o valoare implicită (ADD COLUMN activ INTEGER NOT NULL DEFAULT 1) sau adaugă coloana fără NOT NULL și completeaz-o după. table produse has 5 columns but 2 values were supplied Ai scris INSERT INTO produse VALUES (...) fără listă de coloane, iar SQLite cere atunci câte o valoare pentru fiecare coloană a tabelului. Scrie lista coloanelor pe care le completezi: INSERT INTO produse (nume, pret) VALUES (...). Î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.
