...
Eroare Spring Boot · Validare

size must be between 3 and 50

Pe scurt

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

Greșit
JAVA
record Recenzie(@Size(min = 10, max = 500) String text) { }
// {} trece, text = null
Corect
JAVA
record Recenzie(@NotBlank @Size(min = 10, max = 500) String text) { }

@NotBlank respinge lipsa, @Size lungimea.

2Text prea scurt sau prea lung

Greșit
JAVA
{"text": "Bun"}
Corect
JAVA
{"text": "Produs bun, livrare rapidă"}

Regula cere minimum 10 caractere; clientul trebuie să respecte limita.

Repară tu

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.

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

Alte forme ale mesajului

  • size must be between 0 and 50
  • size 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ă @Size cu @NotBlank pentru 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

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