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

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.

Pe scurt

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

Greșit
C#
public class Produs
{
    public Produs(string numeProdus) { Nume = numeProdus; }
    public string Nume { get; }
}
Corect
C#
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

Greșit
C#
public class Comanda
{
    public Comanda(decimal total, decimal tva) { Total = total + tva; }
    public decimal Total { get; }
}
Corect
C#
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ă tu

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.

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 Produs(string numeProdus, decimal pretProdus)
    {
        Nume = numeProdus;
        Pret = pretProdus;
    }

    public string Nume { get; }
    public decimal Pret { get; }
}
După reparație, programul afișează
POST /produse → 201 Created
Location: /produse/1
{"nume":"Mouse","pret":99}
Indiciu

Compară numele parametrilor constructorului cu numele proprietăților.

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

← 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.