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

System.InvalidOperationException: 'cod' is not a route parameter.

Pe scurt

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

Greșit
C#
app.MapGet("/produse/{id}", ([FromRoute] int cod) => cod);
Corect
C#
app.MapGet("/produse/{id}", ([FromRoute] int id) => id);

Numele parametrului C# trebuie să fie cel din acolade.

2Vrei alt nume în C#

Greșit
C#
app.MapGet("/comenzi/{nr}", ([FromRoute] int numarComanda) => numarComanda);
Corect
C#
app.MapGet("/comenzi/{nr}", ([FromRoute(Name = "nr")] int numarComanda) => numarComanda);

Proprietatea Name leagă explicit parametrul C# de numele din șablon.

Repară tu

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

Codul care dă eroarea
C#
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();
După reparație, programul afișează
GET /comenzi/15 → 200 OK
Comanda 15 este în livrare
Indiciu

Numele din [FromRoute] trebuie să corespundă cu numele din acoladele rutei.

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

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