...
Eroare Spring Boot · Validare

HV000030: No validator could be found for constraint 'jakarta.validation.constraints.NotBlank' validating type 'java.lang.Integer'. Check configuration for 'cantitate'

Pe scurt

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

Greșit
JAVA
record Linie(@NotBlank Integer cantitate) { }
Corect
JAVA
record Linie(@NotNull @Min(1) Integer cantitate) { }

Pentru numere, prezența o verifică @NotNull, iar valoarea @Min/@Positive.

2@Size pe un număr

Greșit
JAVA
@Size(max = 100) int stoc;
Corect
JAVA
@Max(100) int stoc;

@Size măsoară lungimi, nu valori.

3@Email pe alt tip decât text

Greșit
JAVA
@Email Contact contact;
Corect
JAVA
@Valid Contact contact;  // cu @Email pe câmpul String din Contact

Constrângerea se pune pe câmpul text, iar obiectul imbricat se validează cu @Valid.

Repară tu

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.

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 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);
    }
}
După reparație, programul afișează
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 Mouse
Indiciu

Pentru un Integer folosește @NotNull și @Min(1).

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

← 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.