Microsoft.AspNetCore.Routing.Matching.AmbiguousMatchException: The request matched multiple endpoints. Matches:
Două rute se potrivesc la fel de bine cu aceeași cerere, de exemplu /clienti/{id} și /clienti/{email}, iar ASP.NET Core nu poate alege și răspunde 500. Fă rutele distincte: o constrângere ({id:int}) sau un segment fix diferit (/clienti/email/{email}).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când mai multe endpoint-uri se potrivesc cu o cerere, rutarea alege pe cel mai specific: segmentele fixe bat parametrii, parametrii cu constrângere bat parametrii simpli, iar catch-all-ul vine ultimul. Dacă două rute au exact aceeași prioritate și aceeași metodă HTTP, nu există un câștigător, iar la cerere se aruncă AmbiguousMatchException (500 în aplicație, cu pagina de eroare în Development).
Mesajul listează după „Matches:” rutele în conflict, de exemplu HTTP: GET /clienti/{id} și HTTP: GET /clienti/{email}, sau acțiunile de controller (ClientiController.GetById, ClientiController.GetByEmail). Numele parametrilor nu contează pentru rutare: {id} și {email} sunt amândouă „un segment oarecare”. Eroarea apare doar la cererile care ating ambele rute, deci aplicația pornește normal.
De ce apare: cauzele frecvente
1Doi parametri simpli pe aceeași poziție
app.MapGet("/clienti/{id}", (string id) => id);
app.MapGet("/clienti/{email}", (string email) => email);app.MapGet("/clienti/{id:int}", (int id) => id);
app.MapGet("/clienti/{email}", (string email) => email);Constrângerea int face prima rută mai specifică: numerele merg la ea, restul la a doua.
2Două acțiuni [HttpGet] fără șablon
[HttpGet]
public List<Client> Toti() => clienti;
[HttpGet]
public List<Client> Activi() => clienti.Where(c => c.Activ).ToList();[HttpGet]
public List<Client> Toti() => clienti;
[HttpGet("activi")]
public List<Client> Activi() => clienti.Where(c => c.Activ).ToList();Fără șablon, ambele acțiuni primesc ruta controllerului. Un segment fix le separă.
3Aceeași rută definită de două ori
app.MapGet("/produse", () => produse);
// ... mai jos, din copy-paste
app.MapGet("/produse", () => produse.OrderBy(p => p.Nume));app.MapGet("/produse", (string? ordonare) =>
ordonare == "nume" ? produse.OrderBy(p => p.Nume).ToList() : produse);O cale și o metodă trebuie să aibă un singur endpoint; variațiile se fac prin query string.
Repară eroarea, direct în pagină
GET /clienti/2 și GET /clienti/ana@exemplu.ro răspund amândouă cu 500: AmbiguousMatchException: The request matched multiple endpoints. Repară rutele (păstrând căile cererilor) ca numerele să caute după id, iar textul după email.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var clienti = new List<Client> { new(1, "Ana", "ana@exemplu.ro"), new(2, "Mihai", "mihai@exemplu.ro") };
app.MapGet("/clienti/{id}", (string id) => clienti.FirstOrDefault(c => c.Id.ToString() == id));
app.MapGet("/clienti/{email}", (string email) => clienti.FirstOrDefault(c => c.Email == email));
app.Run();
public record Client(int Id, string Nume, string Email);GET /clienti/2 → 200 OK
{"id":2,"nume":"Mihai","email":"mihai@exemplu.ro"}
GET /clienti/ana@exemplu.ro → 200 OK
{"id":1,"nume":"Ana","email":"ana@exemplu.ro"}Indiciu
Fă ruta după id mai specifică decât cea după email, printr-o constrângere de tip.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var clienti = new List<Client> { new(1, "Ana", "ana@exemplu.ro"), new(2, "Mihai", "mihai@exemplu.ro") };
app.MapGet("/clienti/{id:int}", (int id) => clienti.FirstOrDefault(c => c.Id == id));
app.MapGet("/clienti/{email}", (string email) => clienti.FirstOrDefault(c => c.Email == email));
app.Run();
public record Client(int Id, string Nume, string Email);De ce merge
{id} și {email} erau, pentru rutare, același lucru: un segment oarecare, cu aceeași prioritate. Constrângerea {id:int} face prima rută mai specifică, deci 2 ajunge la ea, iar ana@exemplu.ro, care nu e număr, nu se potrivește cu ea și merge la ruta după email. Parametrul devine int id, legat direct din rută.
Alte forme ale mesajului
Microsoft.AspNetCore.Routing.Matching.AmbiguousMatchException: The request matched multiple endpoints. Matches: ClientiController.Toti (Magazin) ClientiController.Activi (Magazin)Microsoft.AspNetCore.Mvc.Routing.AmbiguousActionException: Multiple actions matched.
Cum o eviți pe viitor
- Pentru id-uri numerice folosește mereu constrângerea
{id:int}; pentru căutări alternative, un segment fix (/clienti/email/{email}) sau query string (/clienti?email=...). - La controllere, dă fiecărei acțiuni GET în plus un șablon propriu.
- Scrie un test de integrare care cere fiecare rută: ambiguitatea apare doar la cerere, nu la pornire.
Întrebări frecvente
De ce aplicația pornește, iar eroarea apare abia la cerere?
Pentru că rutele în sine sunt valide. Conflictul există doar pentru căile care se potrivesc cu amândouă, deci e detectat când sosește o astfel de cerere.
Pot da o prioritate manuală unei rute?
Da, cu .WithOrder(n) în Minimal APIs sau Order în atributele de rută (valoarea mai mică câștigă), dar e mai clar să faci rutele diferite prin constrângeri sau segmente.
Erori înrudite
404 Not Found pe o rută cu constrângere ({id:int}, {nume:alpha}) Valoarea din URL nu respectă constrângerea rutei (de exemplu {termen:alpha} primește iphone15), deci ruta nu se potrivește și răspunsul e 404, nu 400. Alege constrângeri care descriu doar forma valorii și validează restul în handler. 405 Method Not Allowed Calea există, dar nu pentru metoda HTTP folosită: de exemplu există GET /produse, iar clientul trimite POST /produse. Adaugă endpoint-ul pentru metoda respectivă (MapPost, MapPut, MapDelete) sau corectează metoda din client. 404 Not Found (nicio rută nu se potrivește cu calea cererii) ASP.NET Core nu a găsit niciun endpoint pentru calea cererii, așa că răspunde 404 fără corp. Compară caracter cu caracter calea cerută cu rutele din MapGet / MapGroup / [Route]: o literă în plus, un prefix uitat sau un singular în loc de plural sunt cele mai dese cauze. Învață ASP.NET Core de la zero, cu exerciții la fiecare lecție
Curs ASP.NET Core: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.
