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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În Minimal APIs, un parametru simplu (string, int, bool, DateTime...) care nu apare în rută este căutat în query string. Dacă tipul nu acceptă lipsa valorii, parametrul e obligatoriu: un int fără valoare implicită și, cu nullable reference types activate (implicit în proiectele noi), un string fără ?. Când cererea nu conține parametrul, handler-ul nu mai rulează: răspunsul e 400 Bad Request, iar în Development corpul conține exact mesajul de mai sus, cu tipul și numele parametrului C#.
În Production corpul e gol, iar motivul apare doar în loguri la nivel Debug. Dacă numele parametrului nu coincide cu ce trimite clientul (q față de termen), efectul e același: pentru binding, termen lipsește. Tot așa apare eroarea când un parametru pe care îl credeai din rută are alt nume decât segmentul din șablon.
De ce apare: cauzele frecvente
1Parametru opțional declarat obligatoriu
app.MapGet("/produse", (string termen) =>
produse.Where(p => p.Nume.Contains(termen)));app.MapGet("/produse", (string? termen) =>
string.IsNullOrEmpty(termen) ? produse : produse.Where(p => p.Nume.Contains(termen)));string? spune că parametrul poate lipsi; handler-ul decide ce face atunci.
2Numele din query diferă de numele parametrului
// clientul cere /produse?pe-pagina=20
app.MapGet("/produse", (int pePagina) => pePagina);app.MapGet("/produse", ([FromQuery(Name = "pe-pagina")] int pePagina = 10) => pePagina);Fără Name, binding-ul caută pePagina. Atributul (din Microsoft.AspNetCore.Mvc) leagă numele real.
3Segment de rută cu alt nume
app.MapGet("/comenzi/{nr:int}", (int id) => id);app.MapGet("/comenzi/{nr:int}", (int nr) => nr);id nu există în rută, deci e căutat în query și lipsește.
Repară eroarea, direct în pagină
Căutarea GET /produse trebuie să funcționeze și fără termen (întoarce toate produsele), dar acum răspunde 400 cu Required parameter "string termen" was not provided from query string.. Repară handler-ul ca ambele cereri să răspundă 200.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<string> { "Laptop", "Mouse", "Mousepad" };
app.MapGet("/produse", (string termen) =>
produse.Where(p => p.Contains(termen, StringComparison.OrdinalIgnoreCase)).ToList());
app.Run();GET /produse → 200 OK ["Laptop","Mouse","Mousepad"] GET /produse?termen=mouse → 200 OK ["Mouse","Mousepad"]
Indiciu
Parametrul trebuie să poată lipsi, iar codul să trateze cazul.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<string> { "Laptop", "Mouse", "Mousepad" };
app.MapGet("/produse", (string? termen) =>
string.IsNullOrWhiteSpace(termen)
? produse
: produse.Where(p => p.Contains(termen, StringComparison.OrdinalIgnoreCase)).ToList());
app.Run();De ce merge
Cu nullable reference types activate, string termen este obligatoriu pentru binding, deci cererea fără ?termen= era oprită cu 400 înainte să ajungă în handler. string? termen îl face opțional: când lipsește, valoarea e null și întorci lista completă; altfel filtrezi cu Contains (aici fără să conteze majusculele).
Alte forme ale mesajului
Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "int pagina" was not provided from query string.Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "string Q" was not provided from query string.
Cum o eviți pe viitor
- Decide pentru fiecare parametru din query dacă e obligatoriu; filtrele și paginarea sunt aproape mereu opționale (
string?,int pagina = 1). - Când numele din URL nu e un identificator C# valid, folosește
[FromQuery(Name = "...")]. - Pentru mulți parametri de filtrare, grupează-i într-un tip cu
[AsParameters]și valori implicite.
Întrebări frecvente
De ce string termen e obligatoriu, deși string poate fi null?
Cu <Nullable>enable</Nullable>, Minimal APIs folosește adnotările: string înseamnă „nu e null”, deci obligatoriu, iar string? înseamnă opțional.
De ce în producție primesc 400 fără niciun text?
Detaliile excepțiilor de binding se scriu în răspuns doar în Development. În producție ai doar statusul; activează AddProblemDetails() și citește logurile ca să vezi motivul.
Erori înrudite
Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "string cheie" was not provided from header. Un parametru marcat [FromHeader] e obligatoriu, iar cererea nu are antetul cu numele căutat. De obicei numele diferă: fără Name, se caută antetul cu numele parametrului C#. Folosește [FromHeader(Name = "X-Api-Key")] sau fă parametrul opțional (string?). 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.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ă. 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")]. Î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.
