...
Eroare Spring Boot · Spring Data JPA: entități și baza de date

NULL not allowed for column "NUME"

Pe scurt

Î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

Greșit
JAVA
@PostMapping("/produse")
Produs adauga(@RequestBody ProdusNou p) {
    return repo.save(new Produs(p.nume()));
}
Corect
JAVA
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

Greșit
JAVA
Produs p = new Produs();
p.setPret(dto.pret());
repo.save(p); // nume rămâne null
Corect
JAVA
Produs 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ă

Greșit
JAVA
{"denumire": "Mouse"}   // clasa are câmpul nume
Corect
JAVA
{"nume": "Mouse"}

Jackson ignoră câmpurile necunoscute, deci nume rămâne null fără nicio eroare la deserializare.

Repară tu

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.

Codul care dă eroarea
JAVA
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()));
    }
}
După reparație, programul afișează
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.

Alte forme ale mesajului

  • ERROR: null value in column "nume" of relation "produs" violates not-null constraint
  • Column 'nume' cannot be null
  • not-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 @Valid pe @RequestBody.
  • Păstrează nullable = false pe 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

← Toate erorile Spring Boot

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