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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fiecare constrângere Bean Validation are validatori pentru anumite tipuri. @NotBlank și @Email merg doar pe texte (CharSequence), @Size pe texte, colecții și tablouri, @Min/@Max pe numere. Când Hibernate Validator găsește o constrângere pe un tip nesuportat, aruncă UnexpectedTypeException: HV000030: No validator could be found for constraint '...NotBlank' validating type 'java.lang.Integer'. Check configuration for 'cantitate'.
Mesajul îți dă tot: adnotarea (NotBlank), tipul câmpului (Integer) și numele câmpului (cantitate). Eroarea apare la prima validare a obiectului, adică la prima cerere, nu la pornire, iar clientul primește 500 (nu 400), pentru că e o greșeală de cod.
Apare des după ce schimbi tipul unui câmp din String în număr și uiți adnotările, sau când copiezi adnotările de pe alt câmp.
De ce apare: cauzele frecvente
1@NotBlank pe un număr
record Linie(@NotBlank Integer cantitate) { }record Linie(@NotNull @Min(1) Integer cantitate) { }Pentru numere, prezența o verifică @NotNull, iar valoarea @Min/@Positive.
2@Size pe un număr
@Size(max = 100) int stoc;@Max(100) int stoc;@Size măsoară lungimi, nu valori.
3@Email pe alt tip decât text
@Email Contact contact;@Valid Contact contact; // cu @Email pe câmpul String din ContactConstrângerea se pune pe câmpul text, iar obiectul imbricat se validează cu @Valid.
Repară eroarea, direct în pagină
LinieComanda are @NotBlank pe câmpul numeric cantitate. În Spring Boot real orice cerere dă 500 cu HV000030: No validator could be found (în laborator regula pur și simplu nu se aplică, așa că o cantitate 0 trece). Înlocuiește adnotarea cu reguli pentru numere: obligatoriu și minimum 1, ca cantitate: 0 să primească 400.
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 LinieComanda(@NotBlank String produs, @NotBlank Integer cantitate) {
}
@RestController
class ComandaController {
@PostMapping("/comenzi/linii")
String adauga(@Valid @RequestBody LinieComanda l) {
return l.cantitate() + " x " + l.produs();
}
}
@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 /comenzi/linii → 400
{"cantitate":"must be greater than or equal to 1"}
POST /comenzi/linii → 200
2 x MouseIndiciu
Pentru un Integer folosește @NotNull și @Min(1).
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 LinieComanda(@NotBlank String produs, @NotNull @Min(1) Integer cantitate) {
}
@RestController
class ComandaController {
@PostMapping("/comenzi/linii")
String adauga(@Valid @RequestBody LinieComanda l) {
return l.cantitate() + " x " + l.produs();
}
}
@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
@NotBlank are validator doar pentru texte; pe un Integer, Hibernate Validator nu știe ce să facă și aruncă HV000030 la prima validare. Pentru numere, prezența se verifică cu @NotNull, iar valoarea cu @Min(1). Acum cantitatea 0 e respinsă cu must be greater than or equal to 1, iar 2 trece. Observă că @NotBlank rămâne corect pe produs, care este text.
Alte forme ale mesajului
HV000030: No validator could be found for constraint 'jakarta.validation.constraints.Size' validating type 'java.lang.Integer'jakarta.validation.UnexpectedTypeException: HV000030
Cum o eviți pe viitor
- Reține perechile: texte →
@NotBlank,@Size,@Email,@Pattern; numere →@NotNull,@Min,@Max,@Positive; liste →@NotEmpty,@Size. - Când schimbi tipul unui câmp, revizuiește-i adnotările.
- Scrie un test cu un obiect invalid pentru fiecare DTO nou: eroarea apare imediat, nu în producție.
Întrebări frecvente
De ce primesc 500 și nu 400?
Pentru că nu datele clientului sunt greșite, ci configurarea validării din cod.
Cum verific că un număr există și e pozitiv?
@NotNull @Positive Integer cantitate. Cu un int primitiv, @NotNull nu are sens (nu poate fi null), iar lipsa devine 0.
Erori înrudite
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"). 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. 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. Î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.
