The JSON value could not be converted to System.Decimal. Path: $.pret | LineNumber: 0 | BytePositionInLine: 15.
System.Text.Json nu poate pune valoarea din JSON în tipul proprietății: de exemplu prețul vine ca "99,50" (cu virgulă) într-un decimal, sau un enum vine ca nume fără JsonStringEnumConverter. Path arată exact câmpul. Trimite formatul corect sau configurează serializatorul să-l accepte.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine din System.Text.Json, la deserializarea corpului. Se citește pe bucăți: could not be converted to System.Decimal este tipul destinație; Path: $.pret e calea în JSON ($ = rădăcina, deci proprietatea pret de pe primul nivel); LineNumber și BytePositionInLine dau poziția exactă în corp.
Într-un controller cu [ApiController], eroarea apare în errors sub cheia $.pret, de obicei însoțită de "date": ["The date field is required."] (parametrul a rămas null pentru că deserializarea a eșuat).
Cazuri tipice: număr cu virgulă zecimală ("99,50"), bool scris "da", enum trimis ca nume fără JsonStringEnumConverter, dată într-un format necunoscut, obiect unde se aștepta listă sau invers. ASP.NET Core folosește setările „web” ale serializatorului, care acceptă numere scrise între ghilimele ("99.50"), dar nu și virgula sau textul.
De ce apare: cauzele frecvente
1Număr cu virgulă zecimală
// POST {"nume": "Mouse", "pret": "99,50"}
public class ProdusNou { public decimal Pret { get; set; } }// POST {"nume": "Mouse", "pret": 99.50}JSON folosește punctul pentru zecimale. Setările web acceptă și "99.50", dar nu "99,50".
2Enum trimis ca nume
// POST {"stare": "Livrata"}
public enum StareComanda { Noua, Livrata }builder.Services.AddControllers().AddJsonOptions(o =>
o.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter()));Implicit enum-urile sunt numere în JSON. Convertorul acceptă (și scrie) numele valorilor.
3Text în loc de listă
// POST {"etichete": "promo"}
public List<string> Etichete { get; set; } = [];// POST {"etichete": ["promo"]}O listă se trimite ca tablou JSON, chiar dacă are un singur element.
Repară eroarea, direct în pagină
Aplicația de curierat trimite starea comenzii ca text ("stare": "Livrata"), iar POST /api/comenzi/5/stare răspunde 400 cu The JSON value could not be converted to StareComanda. Configurează serializatorul controllerelor să accepte enum-urile ca text, ca ambele cereri (text și număr) să primească 200.
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers(); // TODO: enum-uri ca text în JSON
var app = builder.Build();
app.MapControllers();
app.Run();
public enum StareComanda { Noua, Livrata, Anulata }
public class SchimbareStare
{
public StareComanda Stare { get; set; }
}
[ApiController]
[Route("api/comenzi")]
public class ComenziController : ControllerBase
{
[HttpPost("{id:int}/stare")]
public IActionResult SchimbaStarea(int id, SchimbareStare date) => Ok($"Comanda {id}: {date.Stare}");
}POST /api/comenzi/5/stare → 200 OK Comanda 5: Livrata POST /api/comenzi/6/stare → 200 OK Comanda 6: Anulata
Indiciu
AddJsonOptions(o => o.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter())); convertorul e în System.Text.Json.Serialization.
Reparația
using System.ComponentModel.DataAnnotations;
using System.Text.Json.Serialization;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers().AddJsonOptions(o =>
o.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter()));
var app = builder.Build();
app.MapControllers();
app.Run();
public enum StareComanda { Noua, Livrata, Anulata }
public class SchimbareStare
{
public StareComanda Stare { get; set; }
}
[ApiController]
[Route("api/comenzi")]
public class ComenziController : ControllerBase
{
[HttpPost("{id:int}/stare")]
public IActionResult SchimbaStarea(int id, SchimbareStare date) => Ok($"Comanda {id}: {date.Stare}");
}De ce merge
Implicit, System.Text.Json citește și scrie enum-urile ca numere, deci textul Livrata nu putea fi convertit. JsonStringEnumConverter acceptă numele valorilor (și, implicit, în continuare numerele), iar răspunsurile vor conține și ele numele. Opțiunea se pune pe serializatorul controllerelor, cu AddJsonOptions. Cererea cu numărul 2 merge în continuare, deci clienții vechi nu sunt afectați.
Alte forme ale mesajului
The JSON value could not be converted to StareComanda. Path: $.stare | LineNumber: 0 | BytePositionInLine: 30.The JSON value could not be converted to System.Collections.Generic.List`1[System.String]. Path: $.etichete | LineNumber: 0 | BytePositionInLine: 22.The JSON value could not be converted to System.DateTime. Path: $.data | LineNumber: 0 | BytePositionInLine: 20.
Cum o eviți pe viitor
- Publică un contract clar (OpenAPI) cu tipurile fiecărui câmp.
- Configurează o singură dată opțiunile JSON (
AddJsonOptions), de exemplu enum-urile ca text cuJsonStringEnumConverter. - Folosește data în format ISO 8601 (
2026-11-04sau2026-11-04T10:30:00Z) și punctul pentru zecimale. - Testează cu corpuri invalide și verifică 400.
Întrebări frecvente
De ce mai apare și „The date field is required.”?
Deserializarea a eșuat, deci parametrul acțiunii a rămas null. Validarea raportează și asta. Repară prima eroare (cea cu $.), iar a doua dispare.
De ce merge în Minimal APIs, dar nu în controllere (sau invers)?
Cele două au opțiuni JSON separate: ConfigureHttpJsonOptions pentru Minimal APIs și AddJsonOptions pentru controllere. Configurează-le pe cele pe care le folosești.
Erori înrudite
{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"Cantitate":["The field Cantitate must be between 1 and 100."]}} Un controller cu [ApiController] a validat automat datele primite și a găsit erori, așa că a răspuns 400 cu ValidationProblemDetails înainte să ruleze acțiunea. Proprietatea errors spune, pentru fiecare câmp, ce regulă a picat. Corectează datele trimise sau regula greșită din model. The comanda field is required. Cheia erorii e numele parametrului acțiunii (comanda), nu al unei proprietăți: tot corpul nu a putut fi transformat în obiect, deci parametrul a rămas null. Caută lângă ea a doua eroare (cu $) care spune de ce: JSON invalid, listă în loc de obiect, tip greșit. The value 'laptop-gaming' is not valid for id. Model binding-ul nu a putut converti textul din rută, query sau formular în tipul parametrului: ai cerut int, dar ai primit 'laptop-gaming'. Pune o constrângere de rută ({id:int}) ca valorile greșite să nu ajungă la acțiune, sau trimite valoarea în formatul corect. Î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.
