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

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

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

System.Text.Json creează obiectele în una din trei feluri: printr-un constructor public fără parametri (apoi setează proprietățile), prin singurul constructor public cu parametri, sau prin constructorul marcat explicit cu [JsonConstructor]. Dacă tipul are doi sau mai mulți constructori publici cu parametri și niciunul fără parametri sau marcat, nu poate alege, iar la prima deserializare aruncă această excepție (500 în aplicație).

Se întâmplă când adaugi un constructor „de comoditate” unei clase care avea unul singur, de exemplu Produs(string nume) pe lângă Produs(string nume, decimal pret). Codul tău compilează și merge, dar API-ul se strică la prima cerere. Regula de potrivire a parametrilor rămâne aceeași: numele parametrilor constructorului ales trebuie să corespundă proprietăților.

De ce apare: cauzele frecvente

1Doi constructori cu parametri

Greșit
C#
public class Produs
{
    public Produs(string nume) : this(nume, 0) { }
    public Produs(string nume, decimal pret) { Nume = nume; Pret = pret; }
    public string Nume { get; }
    public decimal Pret { get; }
}
Corect
C#
public class Produs
{
    public Produs(string nume) : this(nume, 0) { }
    [JsonConstructor]
    public Produs(string nume, decimal pret) { Nume = nume; Pret = pret; }
    public string Nume { get; }
    public decimal Pret { get; }
}

[JsonConstructor] (din System.Text.Json.Serialization) spune serializatorului ce constructor să folosească.

2Constructor privat fără parametri

Greșit
C#
public class Comanda
{
    private Comanda() { }
    public Comanda(string client) { Client = client; }
    public Comanda(string client, decimal total) { Client = client; Total = total; }
    public string Client { get; set; } = "";
    public decimal Total { get; set; }
}
Corect
C#
public class Comanda
{
    public Comanda() { }
    public Comanda(string client, decimal total) { Client = client; Total = total; }
    public string Client { get; set; } = "";
    public decimal Total { get; set; }
}

Un constructor fără parametri trebuie să fie public (sau marcat cu [JsonConstructor]) ca să fie folosit.

Repară tu

Repară eroarea, direct în pagină

Cineva a adăugat clasei Produs un constructor scurt, iar acum POST /produse răspunde 500: Deserialization of types without a parameterless constructor, a singular parameterized constructor, or a parameterized constructor annotated with 'JsonConstructorAttribute' is not supported. Repară clasa, păstrând ambii constructori.

Codul care dă eroarea
C#
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapPost("/produse", (Produs produs) => $"{produs.Nume}: {produs.Pret} lei");

app.Run();

public class Produs
{
    public Produs(string nume) : this(nume, 0) { }
    public Produs(string nume, decimal pret)
    {
        Nume = nume;
        Pret = pret;
    }

    public string Nume { get; }
    public decimal Pret { get; }
}
După reparație, programul afișează
POST /produse → 200 OK
Mouse: 99 lei
Indiciu

Serializatorul are nevoie să știe explicit care dintre constructori e pentru JSON.

Alte forme ale mesajului

  • System.NotSupportedException: Deserialization of types without a parameterless constructor, a singular parameterized constructor, or a parameterized constructor annotated with 'JsonConstructorAttribute' is not supported. Type 'Comanda'. Path: $ | LineNumber: 0 | BytePositionInLine: 1.

Cum o eviți pe viitor

  • Păstrează DTO-urile simple: un record pozițional sau o clasă cu constructor fără parametri și proprietăți settable.
  • Când adaugi un constructor nou unei clase serializate, marchează explicit pe cel pentru JSON cu [JsonConstructor].
  • Acoperă endpoint-urile POST/PUT cu un test de integrare.

Întrebări frecvente

De ce merge serializarea (răspunsul), dar nu citirea?

La scriere nu e nevoie de constructor: obiectul există deja. Constructorul contează doar când serializatorul trebuie să creeze obiectul din JSON.

Pot pune [JsonConstructor] pe un constructor privat?

Da, începând cu .NET 8 [JsonConstructor] funcționează și pe constructori privați sau interni. Pentru claritate, în DTO-uri preferă constructori publici.

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.