System.InvalidOperationException: 'cod' is not a route parameter.
Parametrul marcat cu [FromRoute] are alt nume decât parametrul din șablonul rutei (de exemplu ruta are {id}, handler-ul are [FromRoute] int cod). Folosește același nume sau [FromRoute(Name = "id")].
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În Minimal APIs, legarea din rută se face după nume: parametrul {id} din șablon ajunge în parametrul C# numit id. Când pui explicit [FromRoute], îi ceri framework-ului să caute valoarea în rută, iar dacă șablonul nu are un parametru cu acel nume, ASP.NET Core aruncă excepția la pornirea aplicației (când construiește handler-ul), cu numele parametrului căutat.
Fără [FromRoute], aceeași greșeală e mai ascunsă: int cod nu se găsește în rută, deci e căutat în query string, iar cererea primește 400 „Required parameter "int cod" was not provided from query string.”. Atributul face greșeala vizibilă devreme, ceea ce e bine.
Cauza tipică este redenumirea: schimbi {id} în {cod} în rută, dar nu și în handler, sau invers.
De ce apare: cauzele frecvente
1Nume diferite în rută și în handler
app.MapGet("/produse/{id}", ([FromRoute] int cod) => cod);app.MapGet("/produse/{id}", ([FromRoute] int id) => id);Numele parametrului C# trebuie să fie cel din acolade.
2Vrei alt nume în C#
app.MapGet("/comenzi/{nr}", ([FromRoute] int numarComanda) => numarComanda);app.MapGet("/comenzi/{nr}", ([FromRoute(Name = "nr")] int numarComanda) => numarComanda);Proprietatea Name leagă explicit parametrul C# de numele din șablon.
Repară eroarea, direct în pagină
Aplicația nu pornește: System.InvalidOperationException: 'cod' is not a route parameter.. Repară handler-ul ca GET /comenzi/15 să răspundă Comanda 15 este în livrare, fără să schimbi ruta /comenzi/{nr:int}.
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/comenzi/{nr:int}", ([FromRoute] int cod) => $"Comanda {cod} este în livrare");
app.Run();GET /comenzi/15 → 200 OK Comanda 15 este în livrare
Indiciu
Numele din [FromRoute] trebuie să corespundă cu numele din acoladele rutei.
Reparația
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/comenzi/{nr:int}", ([FromRoute(Name = "nr")] int cod) => $"Comanda {cod} este în livrare");
app.Run();De ce merge
Ruta are parametrul nr, dar handler-ul cerea din rută valoarea cod, care nu există, de unde excepția la construirea endpoint-ului. [FromRoute(Name = "nr")] spune exact ce segment să citească, iar parametrul C# își poate păstra numele descriptiv. La fel de corect ar fi fost să-l numești nr.
Alte forme ale mesajului
Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "int cod" was not provided from query string.
Cum o eviți pe viitor
- Când redenumești un parametru de rută, redenumește-l în același timp și în handler (refactorizarea din IDE nu atinge textul șablonului).
- Folosește
[FromRoute]explicit doar când vrei să fii sigur de sursă; atunci greșelile apar la pornire, nu la cereri. - Pentru nume diferite,
[FromRoute(Name = "...")].
Întrebări frecvente
Contează majusculele?
Nu: {Id} în rută și int id în handler se potrivesc. Contează doar ca literele să fie aceleași.
De unde vine [FromRoute]?
Din Microsoft.AspNetCore.Mvc, la fel ca [FromQuery] și [FromHeader], deci ai nevoie de using Microsoft.AspNetCore.Mvc; și în Minimal APIs.
Erori înrudite
Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "int id" was not provided from route. Ruta are un parametru opțional ({id?}), dar handler-ul îl declară obligatoriu (int id). Când cererea vine fără acel segment, binding-ul nu are valoare și răspunde 400. Fă parametrul nullable (int? id) sau dă-i o valoare implicită. Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "string termen" was not provided from query string. Handler-ul are un parametru obligatoriu (string termen, int pagina) care se citește din query string, iar cererea nu l-a trimis. Fă-l opțional (string?, int? sau cu valoare implicită) ori trimite ?termen=... în URL. 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. Î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.
