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}.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Spre deosebire de Ambiguous mapping (detectat la pornire, pentru rute identice), această eroare apare la rulare. Tiparele /produse/{id} și /produse/{cod} arată diferit în cod, deci Spring le înregistrează pe amândouă. Pentru cererea /produse/A12, însă, amândouă se potrivesc la fel de specific: o singură variabilă după /produse/. Numele și tipul variabilelor nu contează la alegere.
Spring aruncă IllegalStateException: Ambiguous handler methods mapped for '/produse/A12', iar clientul primește 500. Mesajul listează metodele în conflict.
Reparația este să faci rutele distincte prin partea literală (/produse/{id} și /produse/cod/{cod}) sau să păstrezi o singură rută care decide în cod. Poți și restrânge variabila cu o expresie regulată: /produse/{id:\\d+} se potrivește doar cu cifre.
De ce apare: cauzele frecvente
1Două variabile pe aceeași poziție
@GetMapping("/produse/{id}") Produs dupaId(@PathVariable long id)
@GetMapping("/produse/{cod}") Produs dupaCod(@PathVariable String cod)@GetMapping("/produse/{id}") Produs dupaId(@PathVariable long id)
@GetMapping("/produse/cod/{cod}") Produs dupaCod(@PathVariable String cod)Segmentul literal cod face rutele diferite pentru orice cerere.
2Fără restricție pe formatul variabilei
@GetMapping("/produse/{id}")@GetMapping("/produse/{id:\\d+}")Cu regex, {id} se potrivește doar cu numere, iar textele ajung la cealaltă rută.
Repară eroarea, direct în pagină
Controller-ul are /produse/{id} (număr) și /produse/{cod} (text). Cererea GET /produse/A12 nu ajunge la căutarea după cod. Mută căutarea după cod pe /produse/cod/{cod}, ca GET /produse/cod/A12 să răspundă Mouse (după cod), iar GET /produse/1 să meargă în continuare.
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 {
@GetMapping("/produse/{id}")
String dupaId(@PathVariable long id) {
return id == 1 ? "Mouse (după id)" : "necunoscut";
}
@GetMapping("/produse/{cod}")
String dupaCod(@PathVariable String cod) {
return cod.equals("A12") ? "Mouse (după cod)" : "necunoscut";
}
}Tomcat started on port 8080 (http) Started Application GET /produse/cod/A12 → 200 Mouse (după cod) GET /produse/1 → 200 Mouse (după id)
Indiciu
Adaugă un segment literal înaintea variabilei {cod}.
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 {
@GetMapping("/produse/{id}")
String dupaId(@PathVariable long id) {
return id == 1 ? "Mouse (după id)" : "necunoscut";
}
@GetMapping("/produse/cod/{cod}")
String dupaCod(@PathVariable String cod) {
return cod.equals("A12") ? "Mouse (după cod)" : "necunoscut";
}
}De ce merge
/produse/{id} și /produse/{cod} au aceeași formă: un segment variabil după /produse/. Pentru o cerere concretă, Spring nu le poate departaja (în Spring Boot real primești 500 cu Ambiguous handler methods). Segmentul literal cod face a doua rută mai specifică și fără suprapunere: /produse/cod/A12 ajunge mereu la căutarea după cod, iar /produse/1 la cea după id.
Alte forme ale mesajului
java.lang.IllegalStateException: Ambiguous handler methods mapped for '/produse/A12'
Cum o eviți pe viitor
- Nu pune două variabile diferite pe aceeași poziție a căii.
- Pentru căutări alternative, folosește segmente literale (
/cod/{cod}) sau parametri de query (/produse?cod=A12). - Testează rutele cu valori de ambele tipuri (număr și text).
- Când adaugi o rută nouă, caută în proiect alte metode pe aceeași cale și aceeași metodă HTTP.
Întrebări frecvente
De ce aplicația pornește totuși?
Pentru că tiparele sunt scrise diferit. Conflictul apare doar când o cerere concretă se potrivește la fel de bine cu amândouă.
Care e diferența față de Ambiguous mapping?
Ambiguous mapping apare la pornire pentru rute identice. Aceasta apare la cerere, pentru rute diferite care se suprapun.
Erori înrudite
Ambiguous mapping. Cannot map 'produsController' method ProdusController#cauta(String) to {GET [/produse]}: There is already 'produsController' bean method ProdusController#toate() mapped. Două metode sunt mapate pe exact aceeași combinație de cale și metodă HTTP, iar Spring nu pornește aplicația. Dă-le căi diferite sau combină-le într-o singură metodă (de exemplu cu un @RequestParam opțional). 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. 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"). Î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.
