System.Text.Json.JsonException: JSON deserialization for type 'Produs' was missing required properties including: 'Nume'.
Clasa are proprietăți marcate `required` (sau `[JsonRequired]`), iar JSON-ul primit nu le conține, cel mai des pentru că numele diferă (`nume` vs `Nume`). Activează `PropertyNameCaseInsensitive = true` (sau `JsonSerializerDefaults.Web`), pune `[JsonPropertyName("nume")]` ori verifică de ce câmpul lipsește din date.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Din .NET 7, System.Text.Json respectă membrii required din C# 11 și atributul [JsonRequired]: dacă o astfel de proprietate nu apare în JSON, deserializarea eșuează cu JsonException: JSON deserialization for type 'Produs' was missing required properties including: 'Nume'. Mesajul enumeră proprietățile lipsă.
De cele mai multe ori câmpul există, dar cu alt nume. Implicit, JsonSerializer.Deserialize compară numele cu majusculele exacte: "nume" din JSON nu se potrivește cu Nume din C#. API-urile web trimit aproape mereu nume în camelCase (nume, pretUnitar).
Alte cauze: API-ul a redenumit câmpul, câmpul e opțional în date (nu trebuia marcat required), sau JSON-ul are o structură diferită ({"produs": {...}} în loc de obiectul direct).
Fără required, aceeași problemă ar trece neobservată: proprietatea ar rămâne null sau 0. Excepția te ajută de fapt să descoperi nepotrivirea.
De ce apare: cauzele frecvente
1Nume în camelCase în JSON
var p = JsonSerializer.Deserialize<Produs>("{\"nume\":\"Pix\"}");var optiuni = new JsonSerializerOptions { PropertyNameCaseInsensitive = true };
var p = JsonSerializer.Deserialize<Produs>("{\"nume\":\"Pix\"}", optiuni);Cu potrivire fără diferență de majuscule, nume completează Nume. new JsonSerializerOptions(JsonSerializerDefaults.Web) face același lucru.
2Nume complet diferit
class Produs
{
public required string Nume { get; set; }
}
// JSON: {"denumire":"Pix"}class Produs
{
[JsonPropertyName("denumire")]
public required string Nume { get; set; }
}JsonPropertyName leagă proprietatea de numele din JSON.
3Câmp care chiar poate lipsi
public required string Descriere { get; set; }public string Descriere { get; set; } = "";Marchează required doar câmpurile fără de care obiectul nu are sens.
Repară eroarea, direct în pagină
Programul citește lista de produse primită de la un API, dar se oprește cu System.Text.Json.JsonException: JSON deserialization for type 'Produs' was missing required properties including: 'Nume'. JSON-ul are câmpurile scrise cu literă mică. Repară deserializarea ca programul să afișeze Pix: 3.5 lei și Caiet: 7 lei.
using System.Text.Json;
string json = "[{\"nume\":\"Pix\",\"pret\":3.5},{\"nume\":\"Caiet\",\"pret\":7}]";
var produse = JsonSerializer.Deserialize<List<Produs>>(json);
foreach (var p in produse)
Console.WriteLine($"{p.Nume}: {p.Pret} lei");
class Produs
{
public required string Nume { get; set; }
public decimal Pret { get; set; }
}Pix: 3.5 lei Caiet: 7 lei
Indiciu
Numele din JSON diferă de cele din C# doar prin majuscule; opțiunile serializatorului pot ignora diferența.
Reparația
using System.Text.Json;
string json = "[{\"nume\":\"Pix\",\"pret\":3.5},{\"nume\":\"Caiet\",\"pret\":7}]";
var optiuni = new JsonSerializerOptions { PropertyNameCaseInsensitive = true };
var produse = JsonSerializer.Deserialize<List<Produs>>(json, optiuni);
foreach (var p in produse)
Console.WriteLine($"{p.Nume}: {p.Pret} lei");
class Produs
{
public required string Nume { get; set; }
public decimal Pret { get; set; }
}De ce merge
Implicit, System.Text.Json compară numele câmpurilor exact, cu majuscule, deci nume din JSON nu completa proprietatea Nume. Fiind required, lipsa ei arunca excepția. Cu PropertyNameCaseInsensitive = true, nume și pret se potrivesc cu Nume și Pret, iar produsele se citesc complet.
Alte forme ale mesajului
System.Text.Json.JsonException: JSON deserialization for type 'Produs' was missing required properties, including the following: Nume
Cum o eviți pe viitor
- Pentru JSON de la API-uri web, folosește
new JsonSerializerOptions(JsonSerializerDefaults.Web)(camelCase, fără diferență de majuscule). - Ține opțiunile într-un singur loc (un câmp
static readonly) și refolosește-le. - Marchează
requiredcâmpurile obligatorii: o excepție clară e mai bună decât unnulldescoperit mai târziu.
Întrebări frecvente
De ce ASP.NET Core nu are problema asta?
Pentru că ASP.NET Core folosește implicit opțiunile Web (camelCase, fără diferență de majuscule). JsonSerializer.Deserialize fără opțiuni folosește potrivirea exactă.
Newtonsoft.Json se comportă la fel?
Newtonsoft compară numele fără diferență de majuscule și ignoră implicit required din C#. Are însă [JsonProperty(Required = Required.Always)], cu un mesaj propriu: „Required property 'Nume' not found in JSON.”
Erori înrudite
System.Text.Json.JsonException: The JSON value could not be converted to System.Int32. Path: $.Varsta | LineNumber: 0 | BytePositionInLine: 27. JSON-ul e valid, dar o valoare nu se potrivește cu tipul proprietății din clasa ta. `Path: $.Varsta` arată proprietatea: de exemplu numărul vine ca text (`"17"`) sau un obiect vine în loc de listă. Schimbă tipul proprietății sau activează `NumberHandling = JsonNumberHandling.AllowReadingFromString`. System.Text.Json.JsonException: '<' is an invalid start of a value. Path: $ | LineNumber: 0 | BytePositionInLine: 0. Textul dat lui `JsonSerializer.Deserialize` nu este JSON valid. Caracterul dintre apostrofuri e primul lucru greșit: `'<'` înseamnă de obicei că ai primit o pagină HTML (o eroare a serverului), iar `'''` că valorile sunt între apostrofuri în loc de ghilimele. Verifică textul înainte și tratează `JsonException`. System.NotSupportedException: Deserialization of types without a parameterless constructor, a singular parameterized constructor, or a parameterized constructor annotated with 'JsonConstructorAttribute' is not supported. Type 'Produs'. Path: $ | LineNumber: 0 | BytePositionInLine: 1. `System.Text.Json` nu știe cum să creeze obiectul: clasa nu are constructor fără parametri și are mai mulți constructori cu parametri. Adaugă un constructor public fără parametri sau marchează constructorul de folosit cu `[JsonConstructor]`. Învață C# de la zero, cu exerciții la fiecare lecție
Curs C#: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
