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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine din System.Text.Json și are trei părți utile: tipul țintă (Stare), calea câmpului în JSON ($.stare) și poziția în text. În ASP.NET Core îl vezi ca excepție interioară a lui „Failed to read parameter ... from the request body as JSON” (400), pe pagina de dezvoltator sau în loguri.
Cazul clasic sunt enum-urile: implicit, System.Text.Json le scrie și le citește ca numere ("stare": 1). Un client care trimite "stare": "Livrata" primește eroarea până adaugi JsonStringEnumConverter în opțiunile JSON ale aplicației (ConfigureHttpJsonOptions pentru Minimal APIs, AddJsonOptions pentru controllere). Alte cauze: "pret": "abc", un obiect unde se aștepta un număr, null pentru un tip valoare non-nullable (int, DateTime), sau o dată în format nerecunoscut.
De ce apare: cauzele frecvente
1Enum trimis ca text fără convertor
// corp: {"produs":"Mouse","stare":"Livrata"}
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();var builder = WebApplication.CreateBuilder(args);
builder.Services.ConfigureHttpJsonOptions(o =>
o.SerializerOptions.Converters.Add(new JsonStringEnumConverter()));
var app = builder.Build();Convertorul citește și scrie enum-urile după nume (fără să conteze majusculele la citire).
2null pentru un tip valoare
public record Comanda(string Produs, int Cantitate);
// corp: {"produs":"Mouse","cantitate":null}public record Comanda(string Produs, int? Cantitate);int nu poate fi null; dacă valoarea e opțională, tipul trebuie să fie int?.
3Dată în format local
// corp: {"data":"31.12.2026"}
public record Rezervare(DateOnly Data);// corp: {"data":"2026-12-31"}
public record Rezervare(DateOnly Data);System.Text.Json citește datele doar în format ISO 8601.
Repară eroarea, direct în pagină
Aplicația de curierat trimite {"produs":"Mouse","stare":"Livrata"} la POST /livrari, iar API-ul răspunde 400 (în spate: The JSON value could not be converted to Stare. Path: $.stare). Configurează aplicația ca stările să circule ca text, în cereri și în răspunsuri.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapPost("/livrari", (Livrare livrare) => livrare);
app.Run();
public enum Stare { InDepozit, InTranzit, Livrata }
public record Livrare(string Produs, Stare Stare);POST /livrari → 200 OK
{"produs":"Mouse","stare":"Livrata"}
POST /livrari → 200 OK
{"produs":"Laptop","stare":"InTranzit"}Indiciu
Opțiunile JSON ale Minimal APIs au o listă de convertoare.
Reparația
using System.Text.Json.Serialization;
var builder = WebApplication.CreateBuilder(args);
builder.Services.ConfigureHttpJsonOptions(o =>
o.SerializerOptions.Converters.Add(new JsonStringEnumConverter()));
var app = builder.Build();
app.MapPost("/livrari", (Livrare livrare) => livrare);
app.Run();
public enum Stare { InDepozit, InTranzit, Livrata }
public record Livrare(string Produs, Stare Stare);De ce merge
Implicit, System.Text.Json așteaptă enum-urile ca numere, deci textul "Livrata" nu putea fi convertit. ConfigureHttpJsonOptions cu JsonStringEnumConverter schimbă opțiunile folosite de Minimal APIs: la citire acceptă numele membrului (și cu alte majuscule), iar la scriere pune numele în loc de număr, de aceea răspunsul conține "stare":"Livrata".
Alte forme ale mesajului
System.Text.Json.JsonException: The JSON value could not be converted to System.Int32. Path: $.cantitate | LineNumber: 0 | BytePositionInLine: 31.System.Text.Json.JsonException: The JSON value could not be converted to System.DateOnly. Path: $.data | LineNumber: 0 | BytePositionInLine: 20.System.Text.Json.JsonException: The JSON value could not be converted to System.Decimal. Path: $.pret | LineNumber: 0 | BytePositionInLine: 27.
Cum o eviți pe viitor
- Decide de la început cum circulă enum-urile în API (recomandat: ca text, cu
JsonStringEnumConverter) și configurează-l global. - Folosește tipuri nullable pentru câmpurile opționale.
- Datele: doar ISO 8601 în JSON.
- Citește
Pathdin mesaj: îți arată exact câmpul.
Întrebări frecvente
Dacă adaug convertorul, răspunsurile se schimbă?
Da: enum-urile din răspunsuri vor fi scrise ca text ("Livrata") în loc de numere. Pentru clienții existenți care așteaptă numere, e o schimbare de contract.
Pot pune convertorul doar pe un enum?
Da, cu atributul [JsonConverter(typeof(JsonStringEnumConverter<Stare>))] pe tipul enum (.NET 8+) sau [JsonConverter(typeof(JsonStringEnumConverter))] pe proprietate.
Erori înrudite
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ă. 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 ...). System.Text.Json.JsonException: JSON deserialization for type 'Produs' was missing required properties, including the following: descriere Tipul are proprietăți marcate required (C# 11) sau [JsonRequired], iar JSON-ul primit nu le conține, deci deserializarea eșuează și cererea primește 400. Trimite câmpul sau, dacă e opțional, scoate required și fă proprietatea nullable. Î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.
