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

Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to read parameter "Produs p" from the request body as JSON.

Pe scurt

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

Greșit
C#
public record Linie(string Produs, int Cantitate);
// corp: {"produs":"Mere","cantitate":1.5}
Corect
C#
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

Greșit
C#
app.MapPost("/comenzi", (Comanda c) => c);
// corp: [{"produs":"Mouse"}]
Corect
C#
app.MapPost("/comenzi", (List<Comanda> comenzi) => comenzi.Count);

Tipul parametrului trebuie să corespundă formei JSON-ului: obiect sau tablou.

3JSON invalid

Greșit
C#
{ "nume": "Mouse", "pret": 99, }
Corect
C#
{ "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ă tu

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.

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

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

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