Missing URI template variable 'idProdus' for method parameter of type long
Numele din @PathVariable nu se regăsește în calea rutei (de exemplu ruta are {id}, iar parametrul cere idProdus). Folosește același nume în ambele locuri: @GetMapping("/produse/{id}") cu @PathVariable("id").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
@PathVariable leagă un segment variabil al căii ({id} din /produse/{id}) de un parametru al metodei, după nume. Numele se ia din adnotare (@PathVariable("id")) sau, dacă lipsește, din numele parametrului Java. Dacă numele cerut nu apare între acolade în cale, Spring aruncă MissingPathVariableException: Missing URI template variable 'idProdus' for method parameter of type long.
Atenție la cod: răspunsul este 500, nu 400, pentru că problema e în codul serverului (o nepotrivire între cale și metodă), nu în cererea clientului.
Apare după o redenumire făcută doar într-un loc (calea sau parametrul), după copierea unei metode, sau când numele parametrului Java diferă de variabila din cale și nu ai pus numele în adnotare.
De ce apare: cauzele frecvente
1Nume diferite în cale și în adnotare
@GetMapping("/produse/{id}")
String unul(@PathVariable("idProdus") long id) { ... }@GetMapping("/produse/{id}")
String unul(@PathVariable("id") long id) { ... }Numele din adnotare trebuie să fie exact cel dintre acolade.
2Parametrul Java are alt nume, fără adnotare cu nume
@GetMapping("/comenzi/{idComanda}")
String unul(@PathVariable long id) { ... }@GetMapping("/comenzi/{idComanda}")
String unul(@PathVariable("idComanda") long id) { ... }Fără nume în adnotare, Spring folosește numele parametrului (id), care nu e în cale.
Repară eroarea, direct în pagină
GET /produse/2 nu răspunde cu produsul, pentru că @PathVariable cere variabila idProdus, care nu există în cale ({id}). În Spring Boot real eroarea este Missing URI template variable 'idProdus'. Corectează numele ca ruta să răspundă Tastatură.
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 Map<Long, String> produse = Map.of(1L, "Mouse", 2L, "Tastatură");
@GetMapping("/produse/{id}")
String unul(@PathVariable("idProdus") long id) {
return produse.getOrDefault(id, "necunoscut");
}
}Tomcat started on port 8080 (http) Started Application GET /produse/2 → 200 Tastatură
Indiciu
Numele din @PathVariable trebuie să fie cel dintre acoladele căii.
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 Map<Long, String> produse = Map.of(1L, "Mouse", 2L, "Tastatură");
@GetMapping("/produse/{id}")
String unul(@PathVariable("id") long id) {
return produse.getOrDefault(id, "necunoscut");
}
}De ce merge
@PathVariable("idProdus") cerea o variabilă care nu exista în calea /produse/{id}, așa că Spring nu avea de unde lua valoarea. Cu @PathVariable("id") (sau doar @PathVariable long id, pentru că parametrul se numește tot id), segmentul 2 din adresă ajunge în parametru. Laboratorul raportează nepotrivirea ca parametru lipsă cu 400; Spring Boot real o raportează ca 500, fiind o greșeală de cod.
Alte forme ale mesajului
Missing URI template variable 'id' for method parameter of type LongMissingPathVariableException
Cum o eviți pe viitor
- Redenumește variabila din cale și parametrul împreună (refactorizarea din IDE le prinde pe amândouă).
- Când numele parametrului Java diferă de variabila din cale, scrie numele explicit în
@PathVariable("..."). - Testează fiecare rută cu o cerere reală după orice redenumire.
Întrebări frecvente
De ce primesc 500 și nu 400?
Pentru că cererea e corectă; problema e o nepotrivire în codul serverului, între calea declarată și parametrul metodei.
Trebuie să scriu mereu numele în @PathVariable?
Nu, dacă parametrul Java are exact numele variabilei din cale și proiectul e compilat cu -parameters (implicit în Spring Boot).
Erori înrudite
No static resource api/produse. În Spring Boot 3.2+, o cerere pentru care nu există niciun controller ajunge la handler-ul de fișiere statice, care nu găsește nimic și răspunde 404 cu NoResourceFoundException. Verifică calea, prefixul @RequestMapping de pe clasă și adnotarea @RestController. 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. Ambiguous handler methods mapped for '/produse/A12': {ProdusController#dupaId(long), ProdusController#dupaCod(String)} Două rute cu variabile pe aceeași poziție (/produse/{id} și /produse/{cod}) se potrivesc la fel de bine cu cererea, iar Spring nu poate alege și răspunde 500. Dă-le forme diferite, de exemplu /produse/{id} și /produse/cod/{cod}. Î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.
