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

Ambiguous mapping. Cannot map 'produsController' method ProdusController#cauta(String) to {GET [/produse]}: There is already 'produsController' bean method ProdusController#toate() mapped.

Pe scurt

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

Greșit
JAVA
@GetMapping("/produse") List<String> toate() { ... }
@GetMapping("/produse") List<String> cauta(@RequestParam String q) { ... }
Corect
JAVA
@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

Greșit
JAVA
@PostMapping("/comenzi") ... plaseaza(...)
@PostMapping("/comenzi") ... anuleaza(...)
Corect
JAVA
@PostMapping("/comenzi") ... plaseaza(...)
@PostMapping("/comenzi/{id}/anulare") ... anuleaza(...)

Fiecare acțiune are calea ei.

3Două controllere cu aceeași rută

Greșit
JAVA
@RequestMapping("/api") class A { @GetMapping("/info") ... }
@RequestMapping("/api") class B { @GetMapping("/info") ... }
Corect
JAVA
@RequestMapping("/api/catalog") class A { ... }
@RequestMapping("/api/stoc") class B { ... }

Prefixele diferite separă controllerele.

Repară tu

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.

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 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();
    }
}
După reparație, programul afișează
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.

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

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