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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
@Size(min = 3, max = 50) verifică lungimea unui String (în caractere), a unei colecții sau a unui tablou (în elemente). Dacă lungimea iese din interval, mesajul implicit este size must be between 3 and 50, cu limitele tale. Doar cu max, mesajul devine size must be between 0 and 50.
Ca toate regulile de formă, @Size consideră null valid. Un câmp care lipsește din JSON trece deci de @Size(min = 3), deși intuitiv „nu are minimum 3 caractere”. Pentru câmpuri obligatorii combini @Size cu @NotBlank (texte) sau @NotNull / @NotEmpty (liste).
@Size nu se pune pe numere: pentru valori numerice folosești @Min, @Max, @Positive. Pus pe un int, ar da eroarea HV000030: No validator could be found.
De ce apare: cauzele frecvente
1Câmpul lipsă trece de @Size
record Recenzie(@Size(min = 10, max = 500) String text) { }
// {} trece, text = nullrecord Recenzie(@NotBlank @Size(min = 10, max = 500) String text) { }@NotBlank respinge lipsa, @Size lungimea.
2Text prea scurt sau prea lung
{"text": "Bun"}{"text": "Produs bun, livrare rapidă"}Regula cere minimum 10 caractere; clientul trebuie să respecte limita.
Repară eroarea, direct în pagină
Recenziile trebuie să aibă un text între 10 și 500 de caractere, dar o cerere fără câmpul text trece de validare și răspunde Recenzie salvată: null. Fă textul obligatoriu, păstrând limitele, ca cererea fără text 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 Recenzie(int nota, @Size(min = 10, max = 500) String text) {
}
@RestController
class RecenzieController {
@PostMapping("/recenzii")
String salveaza(@Valid @RequestBody Recenzie r) {
return "Recenzie salvată: " + r.text();
}
}
@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 /recenzii → 400
{"text":"must not be blank"}
POST /recenzii → 400
{"text":"size must be between 10 and 500"}
POST /recenzii → 200
Recenzie salvată: Produs bun, livrare rapidăIndiciu
@Size nu verifică dacă valoarea există; adaugă o regulă care o face.
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 Recenzie(int nota, @NotBlank @Size(min = 10, max = 500) String text) {
}
@RestController
class RecenzieController {
@PostMapping("/recenzii")
String salveaza(@Valid @RequestBody Recenzie r) {
return "Recenzie salvată: " + r.text();
}
}
@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
@Size verifică lungimea doar când valoarea există; un null e considerat valid, de aceea recenzia fără text trecea. @NotBlank adaugă regula de prezență (și respinge textul doar din spații). Acum cererea fără text primește must not be blank, cea cu Bun primește size must be between 10 and 500, iar cea corectă trece.
Alte forme ale mesajului
size must be between 0 and 50size must be between 1 and 2147483647
Cum o eviți pe viitor
- Pune limite de lungime care corespund coloanelor din baza de date (
@Column(length = 50)). - Combină
@Sizecu@NotBlankpentru câmpuri obligatorii. - Scrie mesaje proprii care spun limitele, de exemplu
Textul trebuie să aibă între {min} și {max} caractere. - Testează valorile de la marginea intervalului.
Întrebări frecvente
Pot folosi limitele în mesaj?
Da: @Size(min = 10, max = 500, message = "între {min} și {max} caractere"). Valorile se completează automat.
Numără @Size spațiile?
Da, @Size numără toate caracterele. Dacă vrei să ignori spațiile de la capete, curăță textul înainte sau validează cu @Pattern.
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"). must be a well-formed email address Este mesajul implicit al lui @Email: valoarea nu arată ca o adresă de email. Atenție: @Email acceptă null și textul gol, deci pentru un email obligatoriu pune și @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.
