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

Page index must not be less than zero

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

PageRequest.of(index, marime) cere un index de pagină mai mare sau egal cu 0. Pentru -1 aruncă IllegalArgumentException: Page index must not be less than zero.

Cauza clasică e conversia: API-ul tău numără paginile de la 1 (cum le vede utilizatorul), Spring Data de la 0, iar codul face pagina - 1. Când clientul trimite pagina=0 (sau nu se gândește că paginile încep de la 1), rezultatul e -1. Mai rar, valoarea negativă vine direct din parametru.

Eroarea apare doar pentru anumite cereri, deci e ușor de ratat în testele „fericite”. Tratează intrarea ca pe orice date de la client: verifică limitele și alege un comportament clar (prima pagină sau 400).

De ce apare: cauzele frecvente

1Scazi 1 fără să verifici

Greșit
JAVA
PageRequest.of(pagina - 1, 10) // pagina=0 -> -1
Corect
JAVA
PageRequest.of(Math.max(0, pagina - 1), 10)

Indexul nu coboară sub 0, deci pagina=0 sau 1 dau prima pagină.

2Configurezi paginile de la 1 în Spring

Greșit
JAVA
Page<Produs> lista(@RequestParam int page) { ... PageRequest.of(page - 1, 10) }
Corect
JAVA
# application.properties
spring.data.web.pageable.one-indexed-parameters=true

Page<Produs> lista(Pageable pageable)

Cu Pageable și această proprietate, Spring face singur conversia și ignoră valorile invalide.

Repară tu

Repară eroarea, direct în pagină

Ruta numără paginile de la 1, iar GET /produse?pagina=0 dă 500 cu Page index must not be less than zero. Încadrează indexul calculat pentru Spring Data ca să nu fie negativ: pagina 0 trebuie să întoarcă tot prima pagină.

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?pagina=0 → 200
[{"id":1,"nume":"Mouse","categorie":"periferice","pret":89},{"id":2,"nume":"Tastatură","categorie":"periferice","pret":199}]
GET /produse?pagina=2 → 200
[{"id":3,"nume":"Monitor","categorie":"ecrane","pret":799},{"id":4,"nume":"Webcam","categorie":"periferice","pret":249}]
Indiciu

Indexul calculat (pagina - 1) nu trebuie să coboare sub 0.

Alte forme ale mesajului

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

Cum o eviți pe viitor

  • Decide o singură convenție pentru API (de la 0 sau de la 1) și documenteaz-o.
  • Fă conversia într-un singur loc și încadrează rezultatul cu Math.max(0, ...).
  • Sau validează parametrul cu @Min(1) și răspunde 400.
  • Scrie un test pentru pagina=0 și pentru o valoare negativă.

Întrebări frecvente

Ce primesc pentru o pagină prea mare?

O pagină goală (content gol), nu o eroare. Doar indexul negativ și mărimea sub 1 sunt invalide.

Cum afișez numărul paginii utilizatorului?

page.getNumber() e indexul de la 0; adaugă 1 când îl afișezi, dacă interfața numără de la 1.

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.