NULL not allowed for column "NUME"
Încerci să salvezi o entitate cu null într-o coloană declarată NOT NULL (de exemplu @Column(nullable = false)). Baza refuză inserarea și primești DataIntegrityViolationException, deci 500. Validează datele înainte (@NotBlank cu @Valid) sau setează valoarea lipsă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la H2 și numește coloana: rândul pe care l-ai trimis are NULL acolo unde schema cere o valoare. Constrângerea NOT NULL apare când pui @Column(nullable = false) pe câmp, când câmpul este cheie străină obligatorie (@ManyToOne(optional = false)) sau când tabela a fost creată de un script cu NOT NULL.
În Spring vezi DataIntegrityViolationException: could not execute statement [NULL not allowed for column "NUME"], iar clientul primește 500. De obicei valoarea lipsește pentru că JSON-ul cererii nu avea câmpul (Jackson lasă null), pentru că ai scris greșit numele câmpului în JSON sau pentru că ai uitat să-l copiezi din DTO în entitate.
Regula sănătoasă: datele greșite ale clientului se opresc la intrare, cu validare și 400, iar constrângerea din bază rămâne doar plasă de siguranță.
De ce apare: cauzele frecvente
1Clientul nu trimite câmpul, iar tu nu validezi
@PostMapping("/produse")
Produs adauga(@RequestBody ProdusNou p) {
return repo.save(new Produs(p.nume()));
}record ProdusNou(@NotBlank String nume) { }
@PostMapping("/produse")
Produs adauga(@Valid @RequestBody ProdusNou p) {
return repo.save(new Produs(p.nume()));
}Cu @NotBlank și @Valid, o cerere fără nume primește 400 înainte să ajungă la bază.
2Ai uitat să copiezi un câmp din DTO în entitate
Produs p = new Produs();
p.setPret(dto.pret());
repo.save(p); // nume rămâne nullProdus p = new Produs();
p.setNume(dto.nume());
p.setPret(dto.pret());
repo.save(p);Maparea incompletă lasă câmpul obligatoriu null.
3Numele câmpului din JSON diferă de cel din clasă
{"denumire": "Mouse"} // clasa are câmpul nume{"nume": "Mouse"}Jackson ignoră câmpurile necunoscute, deci nume rămâne null fără nicio eroare la deserializare.
Repară eroarea, direct în pagină
POST /produse fără nume dă 500 cu NULL not allowed for column "NUME". Validează cererea: numele nu poate lipsi sau fi gol, iar cererea greșită trebuie să primească 400 fără să ajungă la baza de date.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
import jakarta.validation.Valid;
import jakarta.validation.constraints.NotBlank;
import org.springframework.web.bind.annotation.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Entity
class Produs {
@Id
@GeneratedValue
private Long id;
@Column(nullable = false)
private String nume;
private int pret;
protected Produs() {
}
Produs(String nume, int pret) {
this.nume = nume;
this.pret = pret;
}
public Long getId() { return id; }
public String getNume() { return nume; }
public int getPret() { return pret; }
}
record ProdusNou(String nume, int pret) { }
interface ProdusRepository extends JpaRepository<Produs, Long> {
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@PostMapping("/produse")
Produs adauga(@RequestBody ProdusNou p) {
return repo.save(new Produs(p.nume(), p.pret()));
}
}Tomcat started on port 8080 (http)
Started Application
POST /produse → 400
{"status":400,"error":"Bad Request","message":"Validation failed for object='produsNou'. Error count: 1","path":"/produse"}
POST /produse → 200
{"id":1,"nume":"Lampă","pret":50}Indiciu
Pune o adnotare de validare pe componenta nume a record-ului și activeaz-o în controller.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
import jakarta.validation.Valid;
import jakarta.validation.constraints.NotBlank;
import org.springframework.web.bind.annotation.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Entity
class Produs {
@Id
@GeneratedValue
private Long id;
@Column(nullable = false)
private String nume;
private int pret;
protected Produs() {
}
Produs(String nume, int pret) {
this.nume = nume;
this.pret = pret;
}
public Long getId() { return id; }
public String getNume() { return nume; }
public int getPret() { return pret; }
}
record ProdusNou(@NotBlank String nume, int pret) { }
interface ProdusRepository extends JpaRepository<Produs, Long> {
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@PostMapping("/produse")
Produs adauga(@Valid @RequestBody ProdusNou p) {
return repo.save(new Produs(p.nume(), p.pret()));
}
}De ce merge
Fără validare, record-ul primea nume = null, iar eroarea apărea abia la insert, ca 500. Cu @NotBlank pe componentă și @Valid pe parametru, Spring verifică obiectul înainte să apeleze metoda și răspunde 400 cu „Validation failed”. Constrângerea nullable = false rămâne pe entitate ca plasă de siguranță.
Alte forme ale mesajului
ERROR: null value in column "nume" of relation "produs" violates not-null constraintColumn 'nume' cannot be nullnot-null property references a null or transient value : Produs.nume
Cum o eviți pe viitor
- Pune adnotări de validare (
@NotBlank,@NotNull) pe DTO-urile de intrare și@Validpe@RequestBody. - Păstrează
nullable = falsepe coloanele obligatorii: e plasa de siguranță. - Scrie un test care trimite cererea fără câmpul obligatoriu și așteaptă 400.
- Mapează DTO-urile complet, eventual într-un singur loc (un constructor sau o metodă
toEntity).
Întrebări frecvente
De ce nu primesc eroarea dacă scot nullable = false?
Atunci coloana acceptă NULL, iar produsul se salvează fără nume. Eroarea dispare, dar datele devin incomplete: problema se mută în altă parte a aplicației.
Ce diferență e între @NotNull și @Column(nullable = false)?
@NotNull validează obiectul în Java (cu @Valid, la intrare, sau de Hibernate înainte de insert), iar nullable = false creează constrângerea NOT NULL în schemă. Folosite împreună, prima dă erori clare, a doua protejează baza.
Erori înrudite
Unique index or primary key violation: "PUBLIC.UK_PRODUS_COD ON PUBLIC.PRODUS(COD)" Ai încercat să salvezi un rând cu o valoare care există deja într-o coloană unică (sau cu o cheie primară deja folosită). Baza de date refuză, iar Spring aruncă DataIntegrityViolationException, adică 500. Verifică înainte cu existsBy... și răspunde 409, sau tratează excepția. Value too long for column "NUME CHARACTER VARYING(20)" Textul salvat are mai multe caractere decât lungimea coloanei (implicit 255, sau cât ai pus în @Column(length = ...)). Baza refuză inserarea cu DataIntegrityViolationException. Validează lungimea la intrare cu @Size(max = ...) și ține aceeași limită în entitate. Column "PRETUNITAR" not found Instrucțiunea SQL pomenește o coloană care nu există în tabelă. În Spring Boot, cauza tipică e data.sql scris cu numele câmpului Java (pretUnitar) în loc de numele coloanei generate de Hibernate (pret_unitar). Folosește numele în snake_case sau pe cel din @Column(name). Învață Spring Boot de la zero, cu exerciții la fiecare lecție
Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.
