must not be blank
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
{"email": "ana@exemplu.ro"} // fără nume{"nume": "Ana", "email": "ana@exemplu.ro"}Un câmp lipsă devine null, pe care @NotBlank îl respinge.
2Mesajul implicit ajunge la utilizator
record ClientNou(@NotBlank String nume) { }record ClientNou(@NotBlank(message = "Numele este obligatoriu") String nume) { }Mesajul din adnotare înlocuiește textul implicit în engleză.
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ă.
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);
}
}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.
Reparația
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(message = "Numele este obligatoriu") String nume,
@NotBlank(message = "Orașul este obligatoriu") 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);
}
}De ce merge
must not be blank este textul implicit al lui @NotBlank în Hibernate Validator. Când pui message = "...", acel text devine getDefaultMessage() pentru câmpul respectiv, iar handler-ul îl pune în răspuns. Observă că numele format doar dintr-un spațiu e respins: @NotBlank ignoră spațiile, spre deosebire de @NotEmpty. Regula rămâne aceeași, doar mesajul devine potrivit pentru utilizatori.
Alte forme ale mesajului
must not be nullmust not be emptymust 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ă:
@NotBlankpentru texte,@NotNullpentru numere, date și obiecte,@NotEmptypentru 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
MethodArgumentNotValidException: Validation failed for argument [0] in public java.lang.String ClientController.inregistreaza(ClientNou): [Field error in object 'clientNou' on field 'email': rejected value [ana]; default message [must be a well-formed email address]] Corpul primit cu @Valid a încălcat regulile de validare (@NotBlank, @Email, @Min...), iar Spring răspunde 400. Mesajul listează câmpul, valoarea respinsă și motivul. Tratează excepția într-un @RestControllerAdvice ca clientul să primească erorile pe câmpuri. size must be between 3 and 50 Este mesajul implicit al lui @Size: lungimea textului (sau numărul de elemente al listei) e în afara intervalului. Atenție: @Size acceptă null, deci pentru un câmp obligatoriu adaugă @NotNull sau @NotBlank. HV000030: No validator could be found for constraint 'jakarta.validation.constraints.NotBlank' validating type 'java.lang.Integer'. Check configuration for 'cantitate' Ai pus o adnotare de validare pe un tip pe care nu îl suportă, de obicei @NotBlank sau @Size pe un număr. Pentru numere folosește @NotNull, @Min, @Max, @Positive; @NotBlank e doar pentru texte. Î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.
