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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Pentru tipurile simple, Minimal APIs convertește textul din URL cu metoda TryParse a tipului (int.TryParse, decimal.TryParse, Guid.TryParse...), folosind cultura invariantă (punct zecimal). Dacă TryParse întoarce false, handler-ul nu rulează: răspunsul e 400 Bad Request, iar în Development corpul conține tipul și numele parametrului și valoarea primită, între ghilimele.
Cazuri frecvente: un preț cu zecimale într-un int, o virgulă zecimală (99,90 nu trece nici prin decimal, care așteaptă punct), un id text (abc) pe o rută {id} fără constrângere, un bool primit ca da sau 1, un Guid scurtat. Tipurile nullable apar în mesaj ca Nullable<int>. Aceeași regulă se aplică tipurilor proprii care au metoda statică TryParse: când ea întoarce false, apare același mesaj.
De ce apare: cauzele frecvente
1Tip întreg pentru o valoare cu zecimale
app.MapGet("/produse", (int pretMax) => produse.Where(p => p.Pret <= pretMax));
// GET /produse?pretMax=99.90app.MapGet("/produse", (decimal pretMax) => produse.Where(p => p.Pret <= pretMax));int.TryParse("99.90") eșuează; decimal acceptă valoarea cu punct zecimal.
2Rută fără constrângere și valoare text
app.MapGet("/produse/{id}", (int id) => id);
// GET /produse/abc -> 400app.MapGet("/produse/{id:int}", (int id) => id);
// GET /produse/abc -> 404Cu constrângerea int, valorile nenumerice nu se potrivesc cu ruta; fără ea, ruta se potrivește, dar conversia eșuează.
3bool trimis ca text românesc
// GET /produse?inStoc=da
app.MapGet("/produse", (bool inStoc) => inStoc);// GET /produse?inStoc=true
app.MapGet("/produse", (bool inStoc) => inStoc);bool.TryParse acceptă doar true și false (fără să conteze majusculele).
Repară eroarea, direct în pagină
Filtrul de preț GET /produse?pretMax=99.90 răspunde 400 cu Failed to bind parameter "int pretMax" from "99.90".. Repară handler-ul ca filtrul să accepte prețuri cu zecimale și să întoarcă produsele cu prețul cel mult egal cu valoarea dată.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<Produs> { new("Mouse", 89.90m), new("Tastatură", 149m), new("Mousepad", 25.50m) };
app.MapGet("/produse", (int pretMax) => produse.Where(p => p.Pret <= pretMax).ToList());
app.Run();
public record Produs(string Nume, decimal Pret);GET /produse?pretMax=99.90 → 200 OK
[{"nume":"Mouse","pret":89.90},{"nume":"Mousepad","pret":25.50}]
GET /produse?pretMax=30 → 200 OK
[{"nume":"Mousepad","pret":25.50}]Indiciu
Tipul parametrului trebuie să poată reprezenta valori cu zecimale, ca prețurile produselor.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<Produs> { new("Mouse", 89.90m), new("Tastatură", 149m), new("Mousepad", 25.50m) };
app.MapGet("/produse", (decimal pretMax) => produse.Where(p => p.Pret <= pretMax).ToList());
app.Run();
public record Produs(string Nume, decimal Pret);De ce merge
Binding-ul folosește int.TryParse, care nu acceptă 99.90, deci cererea era respinsă cu 400 înainte de handler. Prețurile sunt decimal, așa că și parametrul trebuie să fie decimal: decimal.TryParse cu cultura invariantă citește 99.90, iar comparația p.Pret <= pretMax se face între valori de același tip, fără conversii.
Alte forme ale mesajului
Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "int id" from "abc".Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "Nullable<int> pretMin" from "ieftin".Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "bool activ" from "da".Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "Guid id" from "123".
Cum o eviți pe viitor
- Alege tipul după datele reale:
decimalpentru bani,longpentru id-uri mari,Guiddoar dacă id-urile chiar sunt GUID. - Pune constrângeri de tip pe parametrii de rută (
{id:int}). - Documentează în OpenAPI formatul așteptat (punct zecimal,
true/false,yyyy-MM-dd).
Întrebări frecvente
De ce 99,90 nu merge nici cu decimal?
Binding-ul folosește cultura invariantă, cu punct ca separator zecimal, indiferent de setările serverului. Așa URL-urile au același sens pe orice mașină.
Pot întoarce un mesaj mai prietenos în loc de 400-ul implicit?
Da: primește parametrul ca string?, fă tu TryParse și întoarce Results.ValidationProblem sau Results.BadRequest cu mesajul dorit. Sau folosește un endpoint filter comun.
Erori înrudite
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 ...). 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. 404 Not Found pe o rută cu constrângere ({id:int}, {nume:alpha}) Valoarea din URL nu respectă constrângerea rutei (de exemplu {termen:alpha} primește iphone15), deci ruta nu se potrivește și răspunsul e 404, nu 400. Alege constrângeri care descriu doar forma valorii și validează restul în handler. 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. Î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.
