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

Missing URI template variable 'idProdus' for method parameter of type long

Pe scurt

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

Greșit
JAVA
@GetMapping("/produse/{id}")
String unul(@PathVariable("idProdus") long id) { ... }
Corect
JAVA
@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

Greșit
JAVA
@GetMapping("/comenzi/{idComanda}")
String unul(@PathVariable long id) { ... }
Corect
JAVA
@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ă tu

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ă.

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 Map<Long, String> produse = Map.of(1L, "Mouse", 2L, "Tastatură");

    @GetMapping("/produse/{id}")
    String unul(@PathVariable("idProdus") long id) {
        return produse.getOrDefault(id, "necunoscut");
    }
}
După reparație, programul afișează
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.

Alte forme ale mesajului

  • Missing URI template variable 'id' for method parameter of type Long
  • MissingPathVariableException

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

← 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.