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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Începând cu .NET 7, System.Text.Json respectă modificatorul required din C# 11 (și atributul [JsonRequired]): dacă proprietatea lipsește din JSON, deserializarea aruncă această excepție, cu lista câmpurilor lipsă la final. În ASP.NET Core, ea apare ca excepție interioară a lui „Failed to read parameter ... from the request body as JSON”, cu răspunsul 400.
Atenție la două detalii. Verificarea se face doar pe prezența cheii: "descriere": null trece de ea (dar poate pica validarea ulterioară). Și required e o decizie de contract: dacă îl adaugi pe un câmp pe care clienții vechi nu îl trimit, îi strici. Pentru câmpuri opționale folosește string? fără required; pentru reguli de conținut (nevid, lungime) folosește validarea.
De ce apare: cauzele frecvente
1Câmp opțional marcat required
public class Produs
{
public required string Nume { get; set; }
public required string Descriere { get; set; }
}public class Produs
{
public required string Nume { get; set; }
public string? Descriere { get; set; }
}Doar câmpurile fără de care cererea nu are sens trebuie să fie required.
2Nume diferit în JSON
public required string Denumire { get; set; }
// corp: {"nume":"Mouse"}[JsonPropertyName("nume")]
public required string Denumire { get; set; }Pentru serializator, nume și denumire sunt câmpuri diferite; cheia așteptată lipsește.
Repară eroarea, direct în pagină
Descrierea unui produs e opțională, dar POST /produse fără ea răspunde 400 (în spate: JSON deserialization for type 'Produs' was missing required properties, including the following: descriere). Repară modelul ca produsul fără descriere să fie acceptat, iar numele să rămână obligatoriu.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapPost("/produse", (Produs produs) => Results.Created("/produse/1", produs));
app.Run();
public class Produs
{
public required string Nume { get; set; }
public required string Descriere { get; set; }
public decimal Pret { get; set; }
}POST /produse → 201 Created
Location: /produse/1
{"nume":"Mouse","descriere":null,"pret":99}Indiciu
Modificatorul required cere ca proprietatea să existe în JSON.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapPost("/produse", (Produs produs) => Results.Created("/produse/1", produs));
app.Run();
public class Produs
{
public required string Nume { get; set; }
public string? Descriere { get; set; }
public decimal Pret { get; set; }
}De ce merge
System.Text.Json respectă required: lipsa cheii descriere oprea deserializarea, iar binding-ul răspundea 400. Pentru un câmp opțional, string? Descriere fără required e declarația corectă; lipsa lui din JSON dă null, care apare în răspuns. Nume rămâne required, deci un produs fără nume ar fi respins în continuare.
Alte forme ale mesajului
System.Text.Json.JsonException: JSON deserialization for type 'Comanda' was missing required properties, including the following: client, total
Cum o eviți pe viitor
- Folosește
requiredpentru câmpurile esențiale ale cererii și declară nullable restul. - Când adaugi un câmp obligatoriu într-un API existent, versionează sau dă-i o valoare implicită, ca să nu strici clienții.
- Documentează câmpurile obligatorii (OpenAPI le marchează automat).
Întrebări frecvente
required sau [Required]?
required (C#) e verificat de serializator: cheia trebuie să existe. [Required] (DataAnnotations) e verificat de validare: valoarea nu poate fi null sau goală. Pot fi folosite împreună.
De ce primesc doar 400 fără mesaj în producție?
Detaliile excepției apar doar în Development. Pentru mesaje utile clientului, prinde cazul într-un filtru sau IExceptionHandler și întoarce ProblemDetails cu câmpurile lipsă.
Erori înrudite
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. 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ă. System.InvalidOperationException: Each parameter in the deserialization constructor on type 'Produs' must bind to an object property or field on deserialization. Each parameter name must match with a property or field on the object. Fields are only considered when 'JsonSerializerOptions.IncludeFields' is enabled. The match can be case-insensitive. System.Text.Json creează obiectul prin constructor și potrivește fiecare parametru cu o proprietate după nume. Un parametru numit altfel decât proprietatea (numeProdus față de Nume) nu are pereche, deci tipul nu poate fi deserializat. Redenumește parametrul ca proprietatea. Î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.
