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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un parametru marcat cu ? în șablon (/produse/{id?}) permite ca ruta să se potrivească și fără segment: atât /produse, cât și /produse/3. Dar tipul parametrului C# decide dacă handler-ul acceptă lipsa valorii. int id este obligatoriu: nu poate fi null și nu are valoare implicită, deci când segmentul lipsește, Minimal APIs oprește cererea cu 400 Bad Request și, în Development, cu textul Required parameter "int id" was not provided from route..
Aceeași regulă se aplică la string cu nullable reference types activate: string nume e obligatoriu, string? nume e opțional. În Production corpul răspunsului e gol, deci vezi doar 400, iar motivul apare în loguri la nivel Debug.
De ce apare: cauzele frecvente
1Rută opțională, parametru obligatoriu
app.MapGet("/produse/{id?}", (int id) => produse.First(p => p.Id == id));app.MapGet("/produse/{id?}", (int? id) =>
id is null ? Results.Ok(produse) : Results.Ok(produse.First(p => p.Id == id)));int? acceptă lipsa valorii, iar handler-ul decide ce face în acest caz.
2Valoare implicită în rută, dar nu în handler
app.MapGet("/pagina/{nr?}", (int nr) => nr);app.MapGet("/pagina/{nr=1}", (int nr) => nr);{nr=1} dă valoarea implicită direct din rută, deci parametrul are mereu o valoare.
Repară eroarea, direct în pagină
GET /produse răspunde 400 Bad Request cu Required parameter "int id" was not provided from route., iar GET /produse/2 merge. Repară handler-ul ca fără id să întoarcă toate produsele, iar cu id să întoarcă doar produsul cerut.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<Produs> { new(1, "Laptop"), new(2, "Mouse") };
app.MapGet("/produse/{id?}", (int id) =>
Results.Ok(produse.Where(p => p.Id == id)));
app.Run();
public record Produs(int Id, string Nume);GET /produse → 200 OK
[{"id":1,"nume":"Laptop"},{"id":2,"nume":"Mouse"}]
GET /produse/2 → 200 OK
[{"id":2,"nume":"Mouse"}]Indiciu
Parametrul C# trebuie să poată exprima lipsa id-ului.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<Produs> { new(1, "Laptop"), new(2, "Mouse") };
app.MapGet("/produse/{id?}", (int? id) =>
id is null ? Results.Ok(produse) : Results.Ok(produse.Where(p => p.Id == id)));
app.Run();
public record Produs(int Id, string Nume);De ce merge
{id?} face segmentul opțional pentru rutare, dar int id era obligatoriu pentru binding, deci /produse dădea 400. Cu int? id, lipsa segmentului devine null, iar handler-ul întoarce lista completă; cu segment, id are valoare și se întoarce produsul. Ambele ramuri întorc IResult, deci lambda are un singur tip de retur.
Alte forme ale mesajului
Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "string categorie" was not provided from route.
Cum o eviți pe viitor
- Pentru fiecare
{x?}din rută, declară parametrul nullable (int?,string?) sau cu valoare implicită. - Gândește-te dacă ai nevoie de rută opțională: de multe ori două endpoint-uri (
/produseși/produse/{id:int}) sunt mai clare. - Testează și varianta fără segment.
Întrebări frecvente
De ce primesc 400 și nu 404?
Ruta s-a potrivit (segmentul era opțional), deci nu e 404. Problema apare la legarea parametrilor, după rutare, iar acolo lipsa unei valori obligatorii dă 400.
{id?} și int id = 0 în handler funcționează?
Da: un parametru cu valoare implicită C# e opțional pentru binding. Dar valoarea 0 se confundă ușor cu un id real; int? face cazul „lipsește” explicit.
Erori înrudite
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")]. 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. 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. Î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.
