...
Eroare Spring Boot · Rute și cereri HTTP: 404, 405, 400

Required request parameter 'pagina' for method parameter type int is not present

Pe scurt

Metoda are un parametru @RequestParam obligatoriu, iar cererea nu îl conține în query (?pagina=1), deci Spring răspunde 400. Trimite parametrul, sau fă-l opțional cu defaultValue = "0" / required = false.

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

Ce înseamnă

Implicit, orice @RequestParam este obligatoriu (required = true). Dacă adresa nu conține parametrul (GET /produse în loc de GET /produse?pagina=1), Spring aruncă MissingServletRequestParameterException și răspunde 400 Bad Request. Mesajul spune numele parametrului ('pagina') și tipul din metodă (int).

În log vezi WARN ... Resolved [...MissingServletRequestParameterException: Required request parameter 'pagina' for method parameter type int is not present]. Clientul primește JSON-ul standard de eroare, cu message doar dacă ai server.error.include-message=always.

Alege conștient: dacă parametrul are o valoare naturală implicită (prima pagină, sortare după nume), folosește defaultValue. Dacă poate lipsi și înseamnă „fără filtru”, folosește required = false cu un tip obiect (Integer, String) sau Optional<T>, nu un primitiv, ca să poți primi null.

De ce apare: cauzele frecvente

1Parametrul lipsește, deși are o valoare naturală implicită

Greșit
JAVA
@GetMapping("/produse")
List<Produs> pagina(@RequestParam int pagina) { ... }
Corect
JAVA
@GetMapping("/produse")
List<Produs> pagina(@RequestParam(defaultValue = "0") int pagina) { ... }

defaultValue face parametrul opțional și dă valoarea folosită când lipsește.

2Filtru opțional pe un tip primitiv

Greșit
JAVA
@RequestParam(required = false) int pretMaxim
Corect
JAVA
@RequestParam(required = false) Integer pretMaxim

Un int nu poate fi null; pentru „lipsă” folosește Integer sau Optional<Integer>.

3Parametrul vine în corp, nu în adresă

Greșit
JAVA
POST /abonare cu corpul email=ana@exemplu.ro
@RequestParam String email
Corect
JAVA
POST /abonare?email=ana@exemplu.ro

@RequestParam citește query-ul sau un formular; pentru JSON folosește @RequestBody.

Repară tu

Repară eroarea, direct în pagină

GET /produse (fără parametri) răspunde 400: Required request parameter 'pagina' for method parameter type int is not present. Fă parametrul pagina opțional, cu valoarea implicită 0, ca ambele cereri ale laboratorului să răspundă cu pagina potrivită.

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.*;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

@RestController
class ProdusController {
    private final List<String> produse = List.of("Mouse", "Tastatură", "Monitor", "Cablu");

    @GetMapping("/produse")
    List<String> pagina(@RequestParam int pagina) {
        int start = pagina * 2;
        return produse.subList(start, Math.min(start + 2, produse.size()));
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /produse → 200
["Mouse","Tastatură"]
GET /produse?pagina=1 → 200
["Monitor","Cablu"]
Indiciu

@RequestParam are atributul defaultValue, scris ca text.

Alte forme ale mesajului

  • Required request parameter 'q' for method parameter type String is not present
  • Resolved [org.springframework.web.bind.MissingServletRequestParameterException: Required request parameter 'pagina' for method parameter type int is not present]

Cum o eviți pe viitor

  • Dă defaultValue parametrilor de paginare și sortare.
  • Pentru filtre opționale, folosește tipuri obiect sau Optional.
  • Documentează parametrii (de exemplu cu OpenAPI), ca cei care folosesc API-ul să știe ce e obligatoriu.
  • Testează și cererea fără parametri, nu doar cazul fericit.

Întrebări frecvente

De ce nu văd mesajul în răspuns?

Spring Boot ascunde implicit message din JSON-ul de eroare. Pune server.error.include-message=always în dezvoltare sau tratează excepția cu un @ExceptionHandler.

Ce se întâmplă cu ?pagina= (gol)?

Pentru un parametru cu defaultValue, valoarea goală e înlocuită cu cea implicită. Fără defaultValue, Spring 6 răspunde tot 400.

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.