Required request parameter 'pagina' for method parameter type int is not present
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ă
@GetMapping("/produse")
List<Produs> pagina(@RequestParam int pagina) { ... }@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
@RequestParam(required = false) int pretMaxim@RequestParam(required = false) Integer pretMaximUn int nu poate fi null; pentru „lipsă” folosește Integer sau Optional<Integer>.
3Parametrul vine în corp, nu în adresă
POST /abonare cu corpul email=ana@exemplu.ro
@RequestParam String emailPOST /abonare?email=ana@exemplu.ro@RequestParam citește query-ul sau un formular; pentru JSON folosește @RequestBody.
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ă.
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()));
}
}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.
Reparația
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(defaultValue = "0") int pagina) {
int start = pagina * 2;
return produse.subList(start, Math.min(start + 2, produse.size()));
}
}De ce merge
Un @RequestParam fără atribute este obligatoriu, așa că cererea fără ?pagina= era respinsă cu 400 înainte să ajungă în metodă. defaultValue = "0" îl face opțional: Spring folosește 0 când lipsește, iar cu ?pagina=1 primești a doua pagină. Valoarea implicită se scrie ca text, pentru că parametrii din adresă sunt texte, convertite apoi la int.
Alte forme ale mesajului
Required request parameter 'q' for method parameter type String is not presentResolved [org.springframework.web.bind.MissingServletRequestParameterException: Required request parameter 'pagina' for method parameter type int is not present]
Cum o eviți pe viitor
- Dă
defaultValueparametrilor 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
Method parameter 'id': Failed to convert value of type 'java.lang.String' to required type 'long'; For input string: "recomandate" Valoarea din cale sau din query nu se poate converti în tipul parametrului (aici un text în loc de număr), deci Spring răspunde 400. Adesea cererea a ajuns la ruta /{id} din greșeală: verifică ruta dedicată și tipul parametrului. Required request header 'X-API-Key' for method parameter type String is not present Metoda cere un antet HTTP cu @RequestHeader, iar cererea nu îl are, deci Spring răspunde 400. Trimite antetul din client sau fă-l opțional cu required = false / defaultValue. Required request body is missing Metoda are un parametru @RequestBody, dar cererea a venit fără corp (adesea datele erau în query sau cererea era GET), deci Spring răspunde 400. Trimite JSON-ul în corpul cererii sau citește datele cu @RequestParam dacă vin în adresă. Î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.
