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'. Path: $ | LineNumber: 0 | BytePositionInLine: 1.
`System.Text.Json` nu știe cum să creeze obiectul: clasa nu are constructor fără parametri și are mai mulți constructori cu parametri. Adaugă un constructor public fără parametri sau marchează constructorul de folosit cu `[JsonConstructor]`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Ca să deserializeze un obiect, System.Text.Json trebuie întâi să-l creeze. Are trei variante:
- un constructor public fără parametri, după care completează proprietățile;
- un singur constructor public cu parametri, ai cărui parametri îi potrivește după nume cu câmpurile din JSON;
- constructorul marcat cu
[JsonConstructor], dacă sunt mai mulți.
Când clasa are doar constructori cu parametri și sunt cel puțin doi, serializatorul nu poate alege și aruncă NotSupportedException: Deserialization of types without a parameterless constructor, a singular parameterized constructor, or a parameterized constructor annotated with 'JsonConstructorAttribute' is not supported. Type 'Produs'. Partea Path: $ arată unde e obiectul în JSON ($ = rădăcina, $[0] = primul element dintr-o listă).
Situația apare după ce adaugi în clasă încă un constructor „de comoditate”, sau la clasele din biblioteci care nu au fost gândite pentru JSON. Același mesaj apare și pentru constructori care nu sunt publici.
De ce apare: cauzele frecvente
1Doi constructori cu parametri
class Produs
{
public string Nume { get; }
public decimal Pret { get; }
public Produs(string nume) { Nume = nume; }
public Produs(string nume, decimal pret) { Nume = nume; Pret = pret; }
}class Produs
{
public string Nume { get; }
public decimal Pret { get; }
public Produs(string nume) { Nume = nume; }
[JsonConstructor]
public Produs(string nume, decimal pret) { Nume = nume; Pret = pret; }
}[JsonConstructor] (din System.Text.Json.Serialization) spune ce constructor să folosească serializatorul.
2Clasă simplă de date
class Client
{
public string Nume { get; set; }
public Client(string nume) { Nume = nume; }
public Client(string nume, int varsta) { Nume = nume; }
}class Client
{
public string Nume { get; set; }
public Client() { }
public Client(string nume) { Nume = nume; }
}Cu un constructor fără parametri și proprietăți cu set, serializatorul creează obiectul și completează câmpurile.
3Folosește un record
class Punct
{
public Punct(int x) { }
public Punct(int x, int y) { }
}record Punct(int X, int Y);Un record pozițional are un singur constructor principal, pe care System.Text.Json îl folosește automat.
Repară eroarea, direct în pagină
Programul citește un produs din JSON, dar se oprește cu 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'. Repară clasa ca programul să afișeze Laptop: 3500 lei, garantie 24 luni.
using System.Text.Json;
using System.Text.Json.Serialization;
string json = "{\"Nume\":\"Laptop\",\"Pret\":3500,\"Garantie\":24}";
var p = JsonSerializer.Deserialize<Produs>(json);
Console.WriteLine($"{p.Nume}: {p.Pret} lei, garantie {p.Garantie} luni");
class Produs
{
public string Nume { get; }
public decimal Pret { get; }
public int Garantie { get; }
public Produs(string nume, decimal pret) : this(nume, pret, 12) { }
public Produs(string nume, decimal pret, int garantie)
{
Nume = nume;
Pret = pret;
Garantie = garantie;
}
}Laptop: 3500 lei, garantie 24 luni
Indiciu
Clasa are doi constructori; spune-i serializatorului pe care să-l folosească.
Reparația
using System.Text.Json;
using System.Text.Json.Serialization;
string json = "{\"Nume\":\"Laptop\",\"Pret\":3500,\"Garantie\":24}";
var p = JsonSerializer.Deserialize<Produs>(json);
Console.WriteLine($"{p.Nume}: {p.Pret} lei, garantie {p.Garantie} luni");
class Produs
{
public string Nume { get; }
public decimal Pret { get; }
public int Garantie { get; }
public Produs(string nume, decimal pret) : this(nume, pret, 12) { }
[JsonConstructor]
public Produs(string nume, decimal pret, int garantie)
{
Nume = nume;
Pret = pret;
Garantie = garantie;
}
}De ce merge
Produs avea doi constructori cu parametri și niciunul fără parametri, deci System.Text.Json nu știa pe care să-l aleagă. Atributul [JsonConstructor] pe constructorul complet rezolvă ambiguitatea: serializatorul potrivește parametrii nume, pret, garantie cu câmpurile din JSON (fără diferență de majuscule) și creează obiectul.
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 'Produs'. Path: $[0] | LineNumber: 0 | BytePositionInLine: 2.Newtonsoft.Json.JsonSerializationException: Unable to find a constructor to use for type Produs.
Cum o eviți pe viitor
- Pentru obiectele care vin din JSON, folosește clase simple (DTO) cu proprietăți
{ get; set; }sau record-uri poziționale. - Dacă o clasă are mai mulți constructori, marchează-l pe cel pentru JSON cu
[JsonConstructor]. - Testează deserializarea imediat ce adaugi un constructor nou într-o clasă folosită în API-uri.
Întrebări frecvente
De ce funcționa înainte?
Probabil clasa avea un singur constructor cu parametri, pe care serializatorul îl folosea automat. Când ai adăugat al doilea, alegerea a devenit ambiguă.
Funcționează și cu constructor privat?
Da, dacă îl marchezi cu [JsonConstructor] (din .NET 8 sunt acceptați și constructorii non-publici marcați astfel). Fără atribut, constructorii privați sunt ignorați.
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. Constructorul folosit la deserializare are un parametru al cărui nume nu corespunde niciunei proprietăți a clasei (de exemplu parametrul `denumire` pentru proprietatea `Nume`). Redenumește parametrul exact ca proprietatea (`nume` pentru `Nume`; majusculele nu contează) sau adaugă proprietatea lipsă. System.Text.Json.JsonException: JSON deserialization for type 'Produs' was missing required properties including: 'Nume'. Clasa are proprietăți marcate `required` (sau `[JsonRequired]`), iar JSON-ul primit nu le conține, cel mai des pentru că numele diferă (`nume` vs `Nume`). Activează `PropertyNameCaseInsensitive = true` (sau `JsonSerializerDefaults.Web`), pune `[JsonPropertyName("nume")]` ori verifică de ce câmpul lipsește din date. error CS1729: 'Produs' does not contain a constructor that takes 2 arguments La `new Produs(...)` ai trimis un număr de argumente pentru care clasa nu are constructor. Fie adaugi în clasă un constructor cu acei parametri, fie folosești constructorul existent și setezi restul cu un inițializator de obiect: `new Produs { Nume = "Pix", Pret = 3 }`. Învață C# de la zero, cu exerciții la fiecare lecție
Curs C#: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
