...
Eroare Spring Boot · Validare

must not be blank

Pe scurt

Este mesajul implicit al lui @NotBlank: câmpul a lipsit, a fost null, gol sau doar spații. Trimite o valoare, iar dacă vrei un mesaj pentru utilizatori, scrie-l în adnotare: @NotBlank(message = "Numele este obligatoriu").

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajele must not be blank, must not be null, must not be empty, size must be between 2 and 50, must be greater than or equal to 1 sunt textele implicite din Hibernate Validator, implementarea Bean Validation din Spring Boot. Apar în default message [...] din MethodArgumentNotValidException și în răspunsul tău, dacă afișezi getDefaultMessage().

must not be blank vine de la @NotBlank, care respinge null, "" și textele doar cu spații. Diferențele contează: @NotNull acceptă textul gol, @NotEmpty acceptă " ", @NotBlank nu acceptă niciuna (și se pune doar pe texte).

Mesajele implicite sunt în engleză (sau în limba sistemului, dacă există traducere). Pentru utilizatori, scrie-le explicit cu message = "..." sau centralizat într-un fișier ValidationMessages.properties.

De ce apare: cauzele frecvente

1Câmpul lipsește din JSON

Greșit
JAVA
{"email": "ana@exemplu.ro"}   // fără nume
Corect
JAVA
{"nume": "Ana", "email": "ana@exemplu.ro"}

Un câmp lipsă devine null, pe care @NotBlank îl respinge.

2Mesajul implicit ajunge la utilizator

Greșit
JAVA
record ClientNou(@NotBlank String nume) { }
Corect
JAVA
record ClientNou(@NotBlank(message = "Numele este obligatoriu") String nume) { }

Mesajul din adnotare înlocuiește textul implicit în engleză.

Repară tu

Repară eroarea, direct în pagină

Formularul de înregistrare afișează utilizatorilor mesajele implicite în engleză (must not be blank). Scrie mesaje proprii: Numele este obligatoriu pentru nume și Orașul este obligatoriu pentru oraș, ca răspunsul 400 să le conțină.

Codul care dă eroarea
JAVA
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
import jakarta.validation.Valid;
import jakarta.validation.constraints.*;
import org.springframework.web.bind.MethodArgumentNotValidException;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

record ClientNou(@NotBlank String nume, @NotBlank String oras) {
}

@RestController
class ClientController {
    @PostMapping("/clienti")
    String inregistreaza(@Valid @RequestBody ClientNou client) {
        return "Bun venit, " + client.nume() + "!";
    }
}

@RestControllerAdvice
class EroriValidare {
    @ExceptionHandler(MethodArgumentNotValidException.class)
    ResponseEntity<Map<String, String>> invalid(MethodArgumentNotValidException e) {
        Map<String, String> erori = new TreeMap<>();
        e.getBindingResult().getFieldErrors()
                .forEach(f -> erori.put(f.getField(), f.getDefaultMessage()));
        return ResponseEntity.badRequest().body(erori);
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
POST /clienti → 400
{"nume":"Numele este obligatoriu","oras":"Orașul este obligatoriu"}
Indiciu

Fiecare adnotare de validare are atributul message.

Alte forme ale mesajului

  • must not be null
  • must not be empty
  • must be greater than or equal to 1

Cum o eviți pe viitor

  • Scrie mesaje proprii pentru toate regulile pe care le vede utilizatorul.
  • Alege adnotarea potrivită: @NotBlank pentru texte, @NotNull pentru numere, date și obiecte, @NotEmpty pentru liste.
  • Ține mesajele într-un singur loc (ValidationMessages.properties) dacă aplicația are mai multe limbi.

Întrebări frecvente

Care e diferența dintre @NotNull, @NotEmpty și @NotBlank?

@NotNull respinge doar null. @NotEmpty respinge null și colecțiile sau textele goale. @NotBlank respinge în plus textele formate doar din spații.

Pot traduce mesajele implicite?

Da: creează ValidationMessages.properties cu chei ca jakarta.validation.constraints.NotBlank.message=Câmpul este obligatoriu.

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.