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.
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
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; }
}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
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; }
}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ă 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.
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; }
}POST /produse → 200 OK Mouse: 99 lei
Indiciu
Serializatorul are nevoie să știe explicit care dintre constructori e pentru JSON.
Reparația
using System.Text.Json.Serialization;
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) { }
[JsonConstructor]
public Produs(string nume, decimal pret)
{
Nume = nume;
Pret = pret;
}
public string Nume { get; }
public decimal Pret { get; }
}De ce merge
Cu doi constructori publici cu parametri, System.Text.Json nu avea un criteriu de alegere. [JsonConstructor] pe constructorul complet îl desemnează pentru deserializare; parametrii lui (nume, pret) corespund proprietăților, deci valorile din JSON ajung în obiect. Constructorul scurt rămâne disponibil în cod.
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
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. 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. 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. Î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.
