...
Eroare C# · Fișiere, HTTP, URI și JSON

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.

Pe scurt

`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

Greșit
C#
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; }
}
Corect
C#
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

Greșit
C#
class Client
{
    public string Nume { get; set; }
    public Client(string nume) { Nume = nume; }
    public Client(string nume, int varsta) { Nume = nume; }
}
Corect
C#
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

Greșit
C#
class Punct
{
    public Punct(int x) { }
    public Punct(int x, int y) { }
}
Corect
C#
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ă tu

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.

Codul care dă eroarea
C#
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;
    }
}
După reparație, programul afișează
Laptop: 3500 lei, garantie 24 luni
Indiciu

Clasa are doi constructori; spune-i serializatorului pe care să-l folosească.

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

← Toate erorile C#

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ță 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.