...
Eroare Spring Boot · Repository-uri, interogări și paginare

Page size must not be less than one

Pe scurt

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

Greșit
JAVA
@GetMapping("/produse")
Page<Produs> lista(@RequestParam int size) {
    return repo.findAll(PageRequest.of(0, size));
}
Corect
JAVA
@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

Greșit
JAVA
Page<Produs> lista(@RequestParam int page, @RequestParam int size)
Corect
JAVA
Page<Produs> lista(Pageable pageable)
// spring.data.web.pageable.max-page-size=50

Rezolvatorul Pageable ignoră valorile invalide și aplică limitele din configurare.

Repară tu

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.

Codul care dă eroarea
JAVA
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();
    }
}
După reparație, programul afișează
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.

Alte forme ale mesajului

  • java.lang.IllegalArgumentException: Page size must not be less than one
  • Page index must not be less than zero

Cum o eviți pe viitor

  • Primește paginarea ca Pageable câ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

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