...
Eroare ASP.NET Core · Rutare: 404, 405 și rute ambigue

Microsoft.AspNetCore.Routing.Matching.AmbiguousMatchException: The request matched multiple endpoints. Matches:

Pe scurt

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

Greșit
C#
app.MapGet("/clienti/{id}", (string id) => id);
app.MapGet("/clienti/{email}", (string email) => email);
Corect
C#
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

Greșit
C#
[HttpGet]
public List<Client> Toti() => clienti;

[HttpGet]
public List<Client> Activi() => clienti.Where(c => c.Activ).ToList();
Corect
C#
[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

Greșit
C#
app.MapGet("/produse", () => produse);
// ... mai jos, din copy-paste
app.MapGet("/produse", () => produse.OrderBy(p => p.Nume));
Corect
C#
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ă tu

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.

Codul care dă eroarea
C#
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);
După reparație, programul afișează
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.

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

← Toate erorile ASP.NET Core

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