Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to read parameter "Produs p" from the request body as JSON.
Corpul cererii nu a putut fi deserializat în tipul parametrului: JSON invalid, o valoare de alt tip (1.5 într-un int, text într-un număr) sau un tablou în loc de obiect. Corectează datele trimise sau tipul proprietății, astfel încât să corespundă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când un parametru de tip complex se leagă din corp (implicit la POST/PUT, sau cu [FromBody]), Minimal APIs citește JSON-ul cu System.Text.Json. Orice JsonException din deserializare este transformată în această excepție, cu răspunsul 400 Bad Request. Mesajul spune doar ce parametru n-a putut fi citit; cauza exactă e în excepția interioară (InnerException), afișată pe pagina de dezvoltator și în loguri: The JSON value could not be converted to System.Int32. Path: $.cantitate, '}' is an invalid start of a value, Expected start of an object.
Surse tipice: clientul trimite un număr cu zecimale pentru o proprietate int, un text nenumeric pentru un număr, un tablou când API-ul așteaptă un obiect, JSON trunchiat sau cu virgulă la final. Atenție: cu opțiunile web implicite, numerele trimise ca text ("99") sunt acceptate.
De ce apare: cauzele frecvente
1Număr cu zecimale pentru o proprietate int
public record Linie(string Produs, int Cantitate);
// corp: {"produs":"Mere","cantitate":1.5}public record Linie(string Produs, decimal Cantitate);
// corp: {"produs":"Mere","cantitate":1.5}1.5 nu poate deveni int. Pentru cantități la kilogram, tipul corect e decimal.
2Tablou în loc de obiect
app.MapPost("/comenzi", (Comanda c) => c);
// corp: [{"produs":"Mouse"}]app.MapPost("/comenzi", (List<Comanda> comenzi) => comenzi.Count);Tipul parametrului trebuie să corespundă formei JSON-ului: obiect sau tablou.
3JSON invalid
{ "nume": "Mouse", "pret": 99, }{ "nume": "Mouse", "pret": 99 }Virgula de la final, ghilimelele simple și comentariile nu sunt JSON valid pentru System.Text.Json cu opțiunile implicite.
Repară eroarea, direct în pagină
Magazinul vinde fructe la kilogram. POST /cos cu {"produs":"Mere","cantitate":1.5} răspunde 400: Failed to read parameter "Linie linie" from the request body as JSON.. Repară modelul ca linia să fie acceptată și răspunsul să fie 1.5 kg Mere.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapPost("/cos", (Linie linie) => $"{linie.Cantitate} kg {linie.Produs}");
app.Run();
public record Linie(string Produs, int Cantitate);POST /cos → 200 OK 1.5 kg Mere POST /cos → 200 OK 2 kg Pere
Indiciu
Uită-te la tipul proprietății care primește valoarea cu zecimale.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapPost("/cos", (Linie linie) => $"{linie.Cantitate} kg {linie.Produs}");
app.Run();
public record Linie(string Produs, decimal Cantitate);De ce merge
Deserializarea eșua pe cantitate: valoarea 1.5 nu poate fi pusă într-un int, iar JsonException devenea 400. Cu decimal Cantitate, JSON-ul se potrivește cu modelul. Celelalte cereri, cu cantități întregi, merg la fel, pentru că un număr întreg este și un decimal valid.
Alte forme ale mesajului
System.Text.Json.JsonException: The JSON value could not be converted to System.Int32. Path: $.cantitate | LineNumber: 0 | BytePositionInLine: 32.System.Text.Json.JsonException: The JSON value could not be converted to Produs. Path: $ | LineNumber: 0 | BytePositionInLine: 1.System.Text.Json.JsonException: The JSON object contains a trailing comma at the end which is not supported in this mode. Change the reader options.
Cum o eviți pe viitor
- Alege tipurile proprietăților după datele reale (cantități fracționare, prețuri:
decimal). - Citește
InnerExceptionîn loguri sau pe pagina de dezvoltator: are calea exactă ($.cantitate). - Validează JSON-ul trimis din client cu un exemplu din documentația OpenAPI.
- Pentru erori mai prietenoase, activează
AddProblemDetails().
Întrebări frecvente
Unde văd exact ce câmp e greșit?
În excepția interioară: pe pagina de excepții din Development, în loguri sau prin IExceptionHandler. Proprietatea Path ($.cantitate) indică câmpul.
De ce "pret": "99" trece, deși e text?
Minimal APIs folosește JsonSerializerDefaults.Web, care include NumberHandling = AllowReadingFromString. Numerele scrise ca text valid sunt acceptate; textele nenumerice nu.
Erori înrudite
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. System.Text.Json.JsonException: 'M' is an invalid start of a value. Path: $ | LineNumber: 0 | BytePositionInLine: 0. Textul dat lui System.Text.Json nu este JSON: începe cu o literă (un text simplu, HTML, un mesaj de eroare) în loc de {, [, " sau un număr. Verifică ce deserializezi; dacă ai salvat un text, salvează-l cu JsonSerializer.Serialize ca să fie JSON valid. 415 Unsupported Media Type Endpoint-ul așteaptă JSON, dar cererea a venit cu alt Content-Type (text/plain, form, XML sau fără antet). Trimite corpul cu Content-Type: application/json, de exemplu cu PostAsJsonAsync sau new StringContent(json, Encoding.UTF8, "application/json"). Microsoft.AspNetCore.Http.BadHttpRequestException: Implicit body inferred for parameter "svc" but no body was provided. Did you mean to use a Service instead? Un parametru de tip clasă nu e înregistrat ca serviciu, așa că Minimal APIs a presupus că vine din corpul cererii, iar cererea nu are corp. De obicei e un serviciu pe care ai uitat să-l înregistrezi: adaugă builder.Services.AddScoped<T>() (sau AddSingleton). Î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.
