Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "Stare stare" from "deschisa".
Minimal APIs convertește enum-urile din query și rută cu Enum.TryParse sensibil la majuscule, deci deschisa nu se potrivește cu Deschisa și răspunsul e 400. Primește valoarea ca string și folosește Enum.TryParse(valoare, ignoreCase: true, out ...).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Pentru un parametru de tip enum, Minimal APIs folosește Enum.TryParse<T>(valoare, out rezultat) fără opțiunea ignoreCase, deci comparația ține cont de majuscule: ?stare=Deschisa merge, ?stare=deschisa și ?stare=DESCHISA dau 400. Pe de altă parte, sunt acceptate și numerele, chiar și cele care nu corespund niciunui membru (?stare=99), ceea ce poate băga valori invalide în cod.
Controllerele MVC se comportă diferit: acolo enum-urile sunt case-insensitive, ceea ce surprinde la mutarea unui endpoint dintr-un model în altul. Pentru API-uri publice, unde clienții scriu valorile cu litere mici, e mai sigur să primești textul și să-l convertești tu, cu ignoreCase: true și cu verificarea Enum.IsDefined.
De ce apare: cauzele frecvente
1Valoare cu litere mici
app.MapGet("/comenzi", (Stare stare) => comenzi.Where(c => c.Stare == stare));
// GET /comenzi?stare=deschisaapp.MapGet("/comenzi", (string stare) =>
Enum.TryParse<Stare>(stare, ignoreCase: true, out var s)
? Results.Ok(comenzi.Where(c => c.Stare == s))
: Results.BadRequest($"Stare necunoscută: {stare}"));Conversia proprie ignoră majusculele și dă un mesaj clar pentru valorile greșite.
2Numele afișat diferit de numele membrului
enum Stare { InLivrare }
// clientul trimite ?stare=in-livrare// acceptă ambele forme: elimină cratimele înainte de TryParse
Enum.TryParse<Stare>(stare.Replace("-", ""), true, out var s);TryParse cunoaște doar numele membrilor C#. Formatul din URL trebuie normalizat.
Repară eroarea, direct în pagină
Aplicația mobilă cere GET /comenzi?stare=deschisa (cu litere mici) și primește 400: Failed to bind parameter "Stare stare" from "deschisa".. Repară handler-ul ca valoarea să fie acceptată indiferent de majuscule, iar o stare necunoscută să dea 400 cu textul Stare necunoscută: <valoare>.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var comenzi = new List<Comanda> { new(1, Stare.Deschisa), new(2, Stare.Livrata), new(3, Stare.Deschisa) };
app.MapGet("/comenzi", (Stare stare) =>
Results.Ok(comenzi.Where(c => c.Stare == stare).Select(c => c.Id)));
app.Run();
public enum Stare { Deschisa, Livrata }
public record Comanda(int Id, Stare Stare);GET /comenzi?stare=deschisa → 200 OK [1,3] GET /comenzi?stare=LIVRATA → 200 OK [2] GET /comenzi?stare=anulata → 400 Bad Request "Stare necunoscută: anulata"
Indiciu
Primește textul și fă conversia în enum tu, cu opțiunea care ignoră majusculele.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var comenzi = new List<Comanda> { new(1, Stare.Deschisa), new(2, Stare.Livrata), new(3, Stare.Deschisa) };
app.MapGet("/comenzi", (string stare) =>
{
if (!Enum.TryParse<Stare>(stare, ignoreCase: true, out var s) || !Enum.IsDefined(s))
return Results.BadRequest($"Stare necunoscută: {stare}");
return Results.Ok(comenzi.Where(c => c.Stare == s).Select(c => c.Id));
});
app.Run();
public enum Stare { Deschisa, Livrata }
public record Comanda(int Id, Stare Stare);De ce merge
Minimal APIs convertea textul cu Enum.TryParse sensibil la majuscule, deci deschisa era respins. Primind parametrul ca string, controlezi conversia: Enum.TryParse<Stare>(stare, ignoreCase: true, out var s) acceptă orice combinație de litere mari și mici. Enum.IsDefined respinge și numerele fără membru, iar pentru valorile greșite întorci un 400 cu mesaj clar.
Alte forme ale mesajului
Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "Nullable<Stare> stare" from "anulata".Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "Categorie categorie" from "carti".
Cum o eviți pe viitor
- Pentru enum-uri în URL, primește
string?și convertește cuEnum.TryParse(..., ignoreCase: true, ...), apoi verificăEnum.IsDefined. - Documentează valorile permise (OpenAPI le listează automat pentru enum-uri).
- Pentru corpul JSON, adaugă
JsonStringEnumConverterca valorile să circule ca text. - Scrie un test pentru valori cu litere mici și mari.
Întrebări frecvente
De ce ?stare=99 trece, iar ?stare=deschisa nu?
Enum.TryParse acceptă orice număr întreg (enum-urile sunt numere în spate) și doar numele exacte ale membrilor. Verifică cu Enum.IsDefined dacă vrei să respingi numerele fără membru.
În controllere merge cu litere mici. De ce?
Model binding-ul MVC folosește alt convertor, care ignoră majusculele pentru enum-uri. Minimal APIs folosește direct Enum.TryParse fără ignoreCase.
Erori înrudite
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. System.Text.Json.JsonException: The JSON value could not be converted to Stare. Path: $.stare | LineNumber: 0 | BytePositionInLine: 35. System.Text.Json nu poate pune valoarea din JSON în tipul proprietății: cel mai des un enum trimis ca text ("Livrata") fără JsonStringEnumConverter, sau un text într-un număr. Adaugă convertorul pentru enum-uri sau corectează tipul. Path arată câmpul. Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "DateOnly de" from "31.12.2026". Datele din URL sunt convertite cu cultura invariantă, care nu înțelege formatul românesc zi.lună.an. Trimite datele în format ISO (2026-12-31) sau primește textul și convertește-l cu DateOnly.TryParseExact și formatul dd.MM.yyyy. Î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.
