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

404 Not Found pe o rută cu constrângere ({id:int}, {nume:alpha})

Pe scurt

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

Greșit
C#
app.MapGet("/cauta/{termen:alpha}", (string termen) => termen);
// GET /cauta/iphone15 -> 404
Corect
C#
app.MapGet("/cauta/{termen:minlength(2)}", (string termen) => termen);
// GET /cauta/iphone15 -> 200

alpha acceptă doar litere ASCII. Constrângerea potrivită aici e doar lungimea minimă.

2range care exclude valori noi

Greșit
C#
app.MapGet("/rapoarte/{an:range(2020,2025)}", (int an) => an);
// GET /rapoarte/2026 -> 404
Corect
C#
app.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

Greșit
C#
app.MapGet("/produse/{cod:int}", (int cod) => cod);
// GET /produse/MS-01 -> 404
Corect
C#
app.MapGet("/produse/{cod}", (string cod) => cod);

Tipul constrângerii trebuie să corespundă formatului real al identificatorului.

Repară tu

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.

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

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 alpha pentru 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}).

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