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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
La pornire, Spring MVC construiește tabelul rutelor din toate adnotările @GetMapping, @PostMapping etc. Dacă două metode revendică aceeași combinație (aceeași cale, aceeași metodă HTTP, aceleași condiții de params/headers/consumes), nu poate decide pe care să o apeleze și oprește pornirea cu IllegalStateException: Ambiguous mapping.
Mesajul numește ambele metode: cea pe care încerca să o înregistreze (ProdusController#cauta(String)), ruta ({GET [/produse]}) și cea deja înregistrată (ProdusController#toate()). Metodele pot fi în controllere diferite.
Apare de obicei după copierea unei metode, când două controllere au același prefix, sau când vrei două variante ale aceleiași rute (cu și fără filtru) și le mapezi pe aceeași cale. Diferența de parametri Java nu contează: contează doar ce vede HTTP.
De ce apare: cauzele frecvente
1Variantă cu și fără filtru pe aceeași cale
@GetMapping("/produse") List<String> toate() { ... }
@GetMapping("/produse") List<String> cauta(@RequestParam String q) { ... }@GetMapping("/produse")
List<String> toate(@RequestParam(required = false) String q) { ... }Un singur handler cu parametru opțional acoperă ambele cazuri.
2Metodă copiată fără schimbarea căii
@PostMapping("/comenzi") ... plaseaza(...)
@PostMapping("/comenzi") ... anuleaza(...)@PostMapping("/comenzi") ... plaseaza(...)
@PostMapping("/comenzi/{id}/anulare") ... anuleaza(...)Fiecare acțiune are calea ei.
3Două controllere cu aceeași rută
@RequestMapping("/api") class A { @GetMapping("/info") ... }
@RequestMapping("/api") class B { @GetMapping("/info") ... }@RequestMapping("/api/catalog") class A { ... }
@RequestMapping("/api/stoc") class B { ... }Prefixele diferite separă controllerele.
Repară eroarea, direct în pagină
Aplicația nu pornește: Ambiguous mapping. Cannot map 'produsController' method. Două metode sunt mapate pe GET /produse. Înlocuiește-le cu o singură metodă care primește q opțional: fără q întoarce toate produsele, cu q doar pe cele care conțin textul.
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", "Mousepad", "Tastatură");
@GetMapping("/produse")
List<String> toate() {
return produse;
}
@GetMapping("/produse")
List<String> cauta(@RequestParam String q) {
return produse.stream().filter(p -> p.contains(q)).toList();
}
}Tomcat started on port 8080 (http) Started Application GET /produse → 200 ["Mouse","Mousepad","Tastatură"] GET /produse?q=Mouse → 200 ["Mouse","Mousepad"]
Indiciu
Un singur @GetMapping("/produse") cu @RequestParam(required = false) String q.
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", "Mousepad", "Tastatură");
@GetMapping("/produse")
List<String> produse(@RequestParam(required = false) String q) {
if (q == null) {
return produse;
}
return produse.stream().filter(p -> p.contains(q)).toList();
}
}De ce merge
Pentru HTTP, ambele metode erau GET /produse: faptul că una avea un parametru Java în plus nu le deosebea, așa că Spring a refuzat să pornească. O singură metodă cu @RequestParam(required = false) String q acoperă ambele cazuri: q este null când lipsește, iar atunci întorci lista completă. Rezultatul e și un API mai simplu pentru client.
Alte forme ale mesajului
java.lang.IllegalStateException: Ambiguous mapping. Cannot map 'comandaController' method
Cum o eviți pe viitor
- Grupează rutele unei resurse într-un singur controller, cu prefix pe clasă.
- Pentru filtre opționale, folosește un singur handler cu parametri
required = false. - Când copiezi o metodă, schimbă calea înainte de orice altceva.
- Pornește aplicația după fiecare rută nouă: eroarea apare imediat.
Întrebări frecvente
Contează dacă metodele au parametri Java diferiți?
Nu. Spring compară doar condițiile HTTP (cale, metodă, params, headers, consumes, produces), nu semnătura Java.
Pot separa după un parametru prezent?
Da, cu @GetMapping(value = "/produse", params = "q"): ruta se alege doar când q e prezent. De obicei un handler cu parametru opțional e mai simplu.
Erori înrudite
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}. Request method 'POST' is not supported Calea există, dar nu acceptă metoda HTTP folosită (de exemplu ai doar @GetMapping, iar clientul trimite POST), deci răspunsul este 405 Method Not Allowed. Adaugă metoda potrivită (@PostMapping) sau trimite cererea cu metoda corectă. 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. Î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.
