...
Eroare SQL · Constrângeri: UNIQUE, NOT NULL, CHECK, chei străine

NOT NULL constraint failed: produse.nume

Pe scurt

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

Greșit
SQL
INSERT INTO produse (categorie, pret, stoc)
VALUES ('Iluminat', 89, 15);
Corect
SQL
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

Greșit
SQL
INSERT INTO produse (nume, categorie, pret)
VALUES (NULL, 'Mobilă', 450);
Corect
SQL
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

Greșit
SQL
UPDATE produse
SET nume = (SELECT nume FROM produse_noi WHERE cod = 'X-1')
WHERE id = 2;
Corect
SQL
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ă tu

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.

Codul care dă eroarea
SQL
INSERT INTO produse (categorie, pret, stoc)
VALUES ('Iluminat', 89, 15);

SELECT nume, pret
FROM produse
WHERE categorie = 'Iluminat'
ORDER BY pret;
După reparație, programul afișează
nume | pret
Bec inteligent | 65.5
Bandă LED | 89
Lampă LED | 120
Indiciu

Coloana nume este obligatorie, dar lipsește din lista de coloane.

Alte forme ale mesajului

  • NOT NULL constraint failed: clienti.nume
  • ERROR 1048 (23000): Column 'nume' cannot be null
  • ERROR 1364 (HY000): Field 'nume' doesn't have a default value
  • ERROR: null value in column "nume" of relation "produse" violates not-null constraint
  • sqlite3.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 coloanele NOT NULL fără DEFAULT.
  • Pentru coloanele care au o valoare firească (status, data creării, cantitate 0), definește DEFAULT la 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);: coloana notnull arată 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

← Toate erorile SQL

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