Page size must not be less than one
Ai creat un PageRequest cu mărimea paginii 0 sau negativă, de obicei dintr-un parametru primit de la client. PageRequest.of verifică și aruncă IllegalArgumentException (500). Validează mărimea (minim 1, plus o limită maximă) sau folosește Pageable, pe care Spring îl normalizează singur.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
PageRequest.of(pagina, marime) verifică argumentele la creare: indexul paginii nu poate fi negativ, iar mărimea trebuie să fie cel puțin 1. Pentru marime = 0 primești IllegalArgumentException: Page size must not be less than one, iar clientul vede 500.
Aproape mereu valoarea vine direct din cerere: ?size=0, un parametru gol sau un calcul greșit. Când primești paginarea ca Pageable în controller, Spring corectează singur valorile absurde (folosește mărimea implicită și limitează maximul). Când construiești PageRequest din int-uri citite cu @RequestParam, verificarea e treaba ta.
Ca regulă, orice parametru de paginare de la client trebuie limitat în ambele direcții: minimul ca să eviți eroarea, maximul ca nimeni să nu ceară un milion de rânduri într-o pagină.
De ce apare: cauzele frecvente
1Mărimea vine de la client fără verificare
@GetMapping("/produse")
Page<Produs> lista(@RequestParam int size) {
return repo.findAll(PageRequest.of(0, size));
}@GetMapping("/produse")
Page<Produs> lista(@RequestParam int size) {
int s = Math.max(1, Math.min(size, 50));
return repo.findAll(PageRequest.of(0, s));
}Limitezi valoarea între 1 și un maxim rezonabil înainte să creezi cererea de pagină.
2Construiești manual ce poate face Spring
Page<Produs> lista(@RequestParam int page, @RequestParam int size)Page<Produs> lista(Pageable pageable)
// spring.data.web.pageable.max-page-size=50Rezolvatorul Pageable ignoră valorile invalide și aplică limitele din configurare.
Repară eroarea, direct în pagină
GET /produse?marime=0 dă 500 cu Page size must not be less than one. Limitează mărimea paginii între 1 și 10 înainte de a crea PageRequest, ca cererea să întoarcă prima pagină cu un produs.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
import org.springframework.data.domain.PageRequest;
import org.springframework.data.domain.Sort;
import org.springframework.web.bind.annotation.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Entity
class Produs {
@Id
@GeneratedValue
private Long id;
private String nume;
private String categorie;
private int pret;
protected Produs() {
}
public Long getId() { return id; }
public String getNume() { return nume; }
public String getCategorie() { return categorie; }
public int getPret() { return pret; }
}
interface ProdusRepository extends JpaRepository<Produs, Long> {
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@GetMapping("/produse")
List<Produs> pagina(@RequestParam(defaultValue = "1") int pagina, @RequestParam(defaultValue = "2") int marime) {
return repo.findAll(PageRequest.of(pagina - 1, marime, Sort.by("id"))).getContent();
}
}Tomcat started on port 8080 (http)
Started Application
GET /produse?marime=0 → 200
[{"id":1,"nume":"Mouse","categorie":"periferice","pret":89}]
GET /produse?pagina=2 → 200
[{"id":3,"nume":"Monitor","categorie":"ecrane","pret":799},{"id":4,"nume":"Webcam","categorie":"periferice","pret":249}]Indiciu
Math.max și Math.min te ajută să încadrezi valoarea.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
import org.springframework.data.domain.PageRequest;
import org.springframework.data.domain.Sort;
import org.springframework.web.bind.annotation.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Entity
class Produs {
@Id
@GeneratedValue
private Long id;
private String nume;
private String categorie;
private int pret;
protected Produs() {
}
public Long getId() { return id; }
public String getNume() { return nume; }
public String getCategorie() { return categorie; }
public int getPret() { return pret; }
}
interface ProdusRepository extends JpaRepository<Produs, Long> {
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@GetMapping("/produse")
List<Produs> pagina(@RequestParam(defaultValue = "1") int pagina, @RequestParam(defaultValue = "2") int marime) {
int m = Math.max(1, Math.min(marime, 10));
return repo.findAll(PageRequest.of(pagina - 1, m, Sort.by("id"))).getContent();
}
}De ce merge
PageRequest.of nu acceptă pagini cu 0 elemente, iar valoarea venea direct din cerere. Acum mărimea e încadrată între 1 și 10: marime=0 devine 1, deci se întoarce primul produs, iar cererile normale rămân neschimbate. Limita de sus protejează baza de pagini uriașe.
Alte forme ale mesajului
java.lang.IllegalArgumentException: Page size must not be less than onePage index must not be less than zero
Cum o eviți pe viitor
- Primește paginarea ca
Pageablecând poți. - Dacă citești
int-uri, limitează-le:Math.max(1, Math.min(size, 50)). - Sau validează cu
@Min(1) @Max(50)pe parametri, ca să răspunzi 400 cu un mesaj clar. - Configurează
spring.data.web.pageable.max-page-size, ca limita să fie aceeași în tot API-ul. - Scrie un test pentru
size=0și pentru o valoare foarte mare.
Întrebări frecvente
Ce întorc pentru size=0: 400 sau o pagină implicită?
Ambele sunt acceptabile, dacă sunt documentate. Multe API-uri aplică tăcut valoarea implicită; altele răspund 400. Important e să nu răspunzi 500.
Paginile încep de la 0 sau de la 1?
În Spring Data de la 0. Dacă API-ul tău numără de la 1, scade 1 o singură dată, la intrare, sau setează spring.data.web.pageable.one-indexed-parameters=true.
Erori înrudite
Page index must not be less than zero Ai cerut o pagină cu index negativ: Spring Data numără paginile de la 0, iar codul a scăzut 1 dintr-o pagină 0 sau a primit o valoare negativă. PageRequest.of aruncă IllegalArgumentException (500). Verifică indexul și conversia între paginile de la 1 și cele de la 0. Unable to locate Attribute with the given name [pretul] on this ManagedType [Produs] Ai cerut sortarea (Sort sau ?sort= în Pageable) după un câmp care nu există în entitate. Hibernate nu găsește atributul și interogarea pică cu 500. Sortează doar după câmpuri existente și, dacă sortarea vine de la client, permite doar o listă de câmpuri cunoscute. Î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.
