...
Eroare ASP.NET Core · Model binding, JSON, 400 și 415

System.Text.Json.JsonException: JSON deserialization for type 'Produs' was missing required properties, including the following: descriere

Pe scurt

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

Greșit
C#
public class Produs
{
    public required string Nume { get; set; }
    public required string Descriere { get; set; }
}
Corect
C#
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

Greșit
C#
public required string Denumire { get; set; }
// corp: {"nume":"Mouse"}
Corect
C#
[JsonPropertyName("nume")]
public required string Denumire { get; set; }

Pentru serializator, nume și denumire sunt câmpuri diferite; cheia așteptată lipsește.

Repară tu

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.

Codul care dă eroarea
C#
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; }
}
După reparație, programul afișează
POST /produse → 201 Created
Location: /produse/1
{"nume":"Mouse","descriere":null,"pret":99}
Indiciu

Modificatorul required cere ca proprietatea să existe în JSON.

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 required pentru 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

← Toate erorile ASP.NET Core

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