...
Eroare C# · Fișiere, HTTP, URI și JSON

System.Text.Json.JsonException: JSON deserialization for type 'Produs' was missing required properties including: 'Nume'.

Pe scurt

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

Greșit
C#
var p = JsonSerializer.Deserialize<Produs>("{\"nume\":\"Pix\"}");
Corect
C#
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

Greșit
C#
class Produs
{
    public required string Nume { get; set; }
}
// JSON: {"denumire":"Pix"}
Corect
C#
class Produs
{
    [JsonPropertyName("denumire")]
    public required string Nume { get; set; }
}

JsonPropertyName leagă proprietatea de numele din JSON.

3Câmp care chiar poate lipsi

Greșit
C#
public required string Descriere { get; set; }
Corect
C#
public string Descriere { get; set; } = "";

Marchează required doar câmpurile fără de care obiectul nu are sens.

Repară tu

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.

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

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ă required câmpurile obligatorii: o excepție clară e mai bună decât un null descoperit 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

← Toate erorile C#

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ță 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.