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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Constrângerile din șablon ({id:int}, {cod:alpha}, {an:range(2000,2100)}, {nume:minlength(3)}) fac parte din potrivirea rutei, nu din validare. Dacă valoarea nu trece constrângerea, ASP.NET Core consideră că ruta nu există pentru acea cale și continuă căutarea; dacă nu găsește altceva, răspunde 404 fără corp.
De aici două surprize. Prima: un client care trimite o valoare greșită (/produse/abc la {id:int}) primește 404, nu 400, deși ruta „există”. A doua: constrângerile prea stricte resping valori legitime: alpha acceptă doar litere a–z (fără cifre, fără diacritice), int respinge numere mai mari decât int.MaxValue, range respinge anii noi. Documentația ASP.NET recomandă explicit: constrângerile servesc la alegerea între rute, nu la validarea datelor.
De ce apare: cauzele frecvente
1alpha pentru un termen care poate avea cifre
app.MapGet("/cauta/{termen:alpha}", (string termen) => termen);
// GET /cauta/iphone15 -> 404app.MapGet("/cauta/{termen:minlength(2)}", (string termen) => termen);
// GET /cauta/iphone15 -> 200alpha acceptă doar litere ASCII. Constrângerea potrivită aici e doar lungimea minimă.
2range care exclude valori noi
app.MapGet("/rapoarte/{an:range(2020,2025)}", (int an) => an);
// GET /rapoarte/2026 -> 404app.MapGet("/rapoarte/{an:int}", (int an) =>
an < 2020 ? Results.BadRequest("An prea vechi") : Results.Ok(an));Regula de business stă în handler, unde poți da un 400 cu mesaj, în loc de un 404 confuz.
3Id numeric pentru coduri cu litere
app.MapGet("/produse/{cod:int}", (int cod) => cod);
// GET /produse/MS-01 -> 404app.MapGet("/produse/{cod}", (string cod) => cod);Tipul constrângerii trebuie să corespundă formatului real al identificatorului.
Repară eroarea, direct în pagină
Căutarea GET /cauta/{termen} răspunde 404 Not Found pentru iphone15, deși pentru laptop merge. Repară constrângerea rutei ca termenii cu cifre să fie acceptați, dar termenii mai scurți de 2 caractere să nu ajungă în handler.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new[] { "laptop gaming", "iphone15 pro", "mouse wireless" };
app.MapGet("/cauta/{termen:alpha}", (string termen) =>
produse.Where(p => p.Contains(termen)).ToList());
app.Run();GET /cauta/laptop → 200 OK ["laptop gaming"] GET /cauta/iphone15 → 200 OK ["iphone15 pro"]
Indiciu
Constrângerea actuală acceptă doar litere; ai nevoie de una care verifică doar lungimea.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new[] { "laptop gaming", "iphone15 pro", "mouse wireless" };
app.MapGet("/cauta/{termen:minlength(2)}", (string termen) =>
produse.Where(p => p.Contains(termen)).ToList());
app.Run();De ce merge
{termen:alpha} se potrivește doar cu litere a–z, deci iphone15 nu se potrivea cu ruta și cererea primea 404. {termen:minlength(2)} păstrează singura regulă de formă care contează (cel puțin două caractere), iar orice combinație de litere și cifre ajunge în handler. Constrângerile decid potrivirea rutei, de aceea trebuie să fie cât mai permisive.
Alte forme ale mesajului
404 Not Found la GET /produse/abc pentru ruta /produse/{id:int}404 Not Found la GET /rapoarte/2026 pentru ruta /rapoarte/{an:range(2020,2025)}
Cum o eviți pe viitor
- Folosește constrângeri de tip (
int,guid) doar ca să deosebești rute, de exemplu/produse/{id:int}de/produse/{slug}. - Pune regulile de business (interval de valori, lungime maximă, format) în handler sau în validare, cu răspuns 400 și mesaj clar.
- Nu folosi
alphapentru texte în română: respinge diacriticele și cifrele.
Întrebări frecvente
De ce nu primesc 400 pentru /produse/abc la {id:int}?
Pentru că pentru rutare abc nu se potrivește cu {id:int}, deci ruta nu e candidată. Dacă vrei 400, scoate constrângerea: {id} cu int id dă 400 „Failed to bind parameter”.
Ce constrângeri există?
int, long, bool, datetime, decimal, double, float, guid, alpha, min, max, range, length, minlength, maxlength, regex și required. Poți combina mai multe: {id:int:min(1)}.
Erori înrudite
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. System.InvalidOperationException: The constraint reference 'integer' could not be resolved to a type. Register the constraint type with 'Microsoft.AspNetCore.Routing.RouteOptions.ConstraintMap'. Ai scris în rută o constrângere care nu există, de exemplu {id:integer} sau {id:number}. Folosește numele reale (int, long, guid, bool, decimal, alpha, min, range...) sau înregistrează constrângerea proprie în RouteOptions.ConstraintMap. Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "int pretMax" from "99.90". Valoarea primită în query, rută sau antet nu poate fi convertită în tipul parametrului (de exemplu 99.90 în int, abc în int). Alege tipul potrivit datelor (decimal pentru prețuri) sau o constrângere de rută, iar pentru intrări greșite răspunsul 400 e corect. 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}). Î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.
