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.
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
PageRequest.of(pagina - 1, 10) // pagina=0 -> -1PageRequest.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
Page<Produs> lista(@RequestParam int page) { ... PageRequest.of(page - 1, 10) }# 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ă 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ă.
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?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.
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 index = Math.max(0, pagina - 1);
return repo.findAll(PageRequest.of(index, marime, Sort.by("id"))).getContent();
}
}De ce merge
Pentru pagina=0, calculul pagina - 1 dădea -1, iar PageRequest.of respinge indexurile negative. Cu Math.max(0, pagina - 1), orice valoare mai mică decât 1 duce la prima pagină, iar pagina=2 rămâne a doua pagină (produsele 3 și 4). Conversia se face într-un singur loc, la intrare.
Alte forme ale mesajului
java.lang.IllegalArgumentException: Page index must not be less than zeroPage 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
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. Query did not return a unique result: 2 results were returned Metoda din repository întoarce un singur obiect (Produs sau Optional<Produs>), dar interogarea a găsit mai multe rânduri. Spring aruncă IncorrectResultSizeDataAccessException (500). Întoarce List<Produs>, limitează cu findFirst, sau asigură unicitatea câmpului. Î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.
