...
Eroare ASP.NET Core · Model binding, JSON, 400 și 415

Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "int pretMax" from "99.90".

Pe scurt

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

Greșit
C#
app.MapGet("/produse", (int pretMax) => produse.Where(p => p.Pret <= pretMax));
// GET /produse?pretMax=99.90
Corect
C#
app.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

Greșit
C#
app.MapGet("/produse/{id}", (int id) => id);
// GET /produse/abc -> 400
Corect
C#
app.MapGet("/produse/{id:int}", (int id) => id);
// GET /produse/abc -> 404

Cu 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

Greșit
C#
// GET /produse?inStoc=da
app.MapGet("/produse", (bool inStoc) => inStoc);
Corect
C#
// GET /produse?inStoc=true
app.MapGet("/produse", (bool inStoc) => inStoc);

bool.TryParse acceptă doar true și false (fără să conteze majusculele).

Repară tu

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

Codul care dă eroarea
C#
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);
După reparație, programul afișează
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.

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: decimal pentru bani, long pentru id-uri mari, Guid doar 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

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