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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Pentru tipurile fără constructor fără parametri (clase cu un singur constructor cu parametri, record-uri poziționale), System.Text.Json folosește acel constructor. Regula: fiecare parametru al constructorului trebuie să corespundă, după nume (fără să conteze majusculele), unei proprietăți publice a tipului. Așa știe serializatorul ce valoare din JSON să dea fiecărui parametru și, la serializare, de unde să citească.
Dacă un parametru se numește numeProdus, iar proprietatea Nume, regula e încălcată și primești această excepție, la prima deserializare a tipului, adică la prima cerere care îl primește în corp (500 în aplicație, nu 400). Record-urile poziționale respectă regula automat, de aceea sunt alegerea comodă pentru DTO-uri. Problema apare la clasele scrise de mână sau după o redenumire parțială.
De ce apare: cauzele frecvente
1Parametru cu alt nume decât proprietatea
public class Produs
{
public Produs(string numeProdus) { Nume = numeProdus; }
public string Nume { get; }
}public class Produs
{
public Produs(string nume) { Nume = nume; }
public string Nume { get; }
}nume se potrivește cu Nume (majusculele nu contează).
2Constructor care primește o valoare fără proprietate
public class Comanda
{
public Comanda(decimal total, decimal tva) { Total = total + tva; }
public decimal Total { get; }
}public record Comanda(decimal Total, decimal Tva)
{
public decimal TotalCuTva => Total + Tva;
}Fiecare parametru are acum o proprietate pereche; valoarea calculată devine o proprietate separată.
Repară eroarea, direct în pagină
POST /produse răspunde 500: Each parameter in the deserialization constructor on type 'Produs' must bind to an object property.... Repară clasa Produs (fără s-o transformi în record) ca produsul primit să fie întors cu 201 Created.
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 Produs(string numeProdus, decimal pretProdus)
{
Nume = numeProdus;
Pret = pretProdus;
}
public string Nume { get; }
public decimal Pret { get; }
}POST /produse → 201 Created
Location: /produse/1
{"nume":"Mouse","pret":99}Indiciu
Compară numele parametrilor constructorului cu numele proprietăților.
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 Produs(string nume, decimal pret)
{
Nume = nume;
Pret = pret;
}
public string Nume { get; }
public decimal Pret { get; }
}De ce merge
Serializatorul construia Produs prin constructor și căuta pentru fiecare parametru o proprietate cu același nume. numeProdus și pretProdus nu aveau pereche, deci tipul nu putea fi deserializat deloc. Cu parametrii nume și pret, potrivirea cu Nume și Pret se face fără să conteze majusculele, iar JSON-ul {"nume":...,"pret":...} ajunge corect în obiect.
Alte forme ale mesajului
System.InvalidOperationException: Each parameter in the deserialization constructor on type 'Comanda' 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.
Cum o eviți pe viitor
- Pentru DTO-uri folosește record-uri poziționale:
public record Produs(string Nume, decimal Pret);. - La clasele cu constructor, păstrează aceleași nume pentru parametri și proprietăți.
- Redenumește cu unealta IDE-ului (Rename), care schimbă și parametrul, nu doar proprietatea.
- Scrie un test care deserializează fiecare DTO dintr-un JSON de exemplu.
Întrebări frecvente
De ce primesc 500 și nu 400?
Problema nu e în datele clientului, ci în tipul tău: serializatorul nu-și poate construi metadatele pentru el. Orice cerere ar da aceeași eroare, deci e o eroare de server.
Pot păstra numele diferite?
Da, dacă pui [JsonPropertyName("nume")] pe proprietate și numele parametrului corespunde acelui nume JSON, sau adaugi un constructor fără parametri cu proprietăți settable. Cel mai simplu e să le aliniezi.
Erori înrudite
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'. Clasa are mai mulți constructori cu parametri și niciunul fără parametri, deci System.Text.Json nu știe pe care să-l folosească. Marchează constructorul dorit cu [JsonConstructor] sau adaugă un constructor public fără parametri. 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. System.NotSupportedException: Deserialization of interface or abstract types is not supported. Type 'IProdus'. Path: $ | LineNumber: 0 | BytePositionInLine: 1. Parametrul din corp e o interfață sau o clasă abstractă, iar System.Text.Json nu știe ce clasă concretă să creeze. Folosește un tip concret (record/DTO) pentru cerere sau, pentru ierarhii, [JsonPolymorphic] cu [JsonDerivedType] și un discriminator. Î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.
