System.InvalidOperationException: The JSON property name for 'Produs.nume' collides with another property.
Două proprietăți ale aceluiași tip ajung la același nume în JSON, de exemplu Nume (camelCase: nume) și Denumire marcată [JsonPropertyName("nume")]. Serializatorul nu poate scrie două chei identice, deci aruncă excepția (500). Dă-le nume JSON diferite sau ignoră una.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Numele din JSON se calculează din numele proprietății C# și politica de denumire (în ASP.NET Core, implicit camelCase: Nume devine nume), sau din [JsonPropertyName]. Dacă două proprietăți din același tip (inclusiv cele moștenite) ajung la același nume JSON, System.Text.Json nu poate construi metadatele tipului și aruncă excepția, cu numele tipului și numele JSON în conflict. Eroarea apare la prima serializare sau deserializare a tipului, deci la prima cerere care îl folosește.
Cazuri reale: o proprietate nouă cu [JsonPropertyName] care refolosește un nume existent, o proprietate din clasa derivată care ascunde (new) una din bază, două proprietăți care diferă doar prin majuscule (Id și ID), sau o politică SnakeCaseLower care transformă PretTotal și Pret_Total în același pret_total.
De ce apare: cauzele frecvente
1[JsonPropertyName] care refolosește un nume
public class Produs
{
public string Nume { get; set; } = "";
[JsonPropertyName("nume")]
public string Denumire { get; set; } = "";
}public class Produs
{
public string Nume { get; set; } = "";
[JsonPropertyName("denumireComerciala")]
public string Denumire { get; set; } = "";
}Fiecare proprietate trebuie să aibă propriul nume în JSON.
2Proprietate veche păstrată pentru compatibilitate
public string Nume { get; set; } = "";
[JsonPropertyName("nume")]
public string NumeVechi => Nume;public string Nume { get; set; } = "";
[JsonIgnore]
public string NumeVechi => Nume;Dacă proprietatea nu trebuie să apară în JSON, [JsonIgnore] o scoate din serializare.
Repară eroarea, direct în pagină
GET /produse/1 răspunde 500: The JSON property name for 'Produs.nume' collides with another property.. Proprietatea Denumire trebuie să apară în JSON ca denumireComerciala. Repară clasa ca răspunsul să conțină nume, denumireComerciala și pret.
using System.Text.Json.Serialization;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/produse/{id:int}", (int id) =>
new Produs { Nume = "Mouse", Denumire = "Mouse wireless M100", Pret = 99m });
app.Run();
public class Produs
{
public string Nume { get; set; } = "";
[JsonPropertyName("nume")]
public string Denumire { get; set; } = "";
public decimal Pret { get; set; }
}GET /produse/1 → 200 OK
{"nume":"Mouse","denumireComerciala":"Mouse wireless M100","pret":99}Indiciu
Două proprietăți ajung acum la același nume în JSON.
Reparația
using System.Text.Json.Serialization;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/produse/{id:int}", (int id) =>
new Produs { Nume = "Mouse", Denumire = "Mouse wireless M100", Pret = 99m });
app.Run();
public class Produs
{
public string Nume { get; set; } = "";
[JsonPropertyName("denumireComerciala")]
public string Denumire { get; set; } = "";
public decimal Pret { get; set; }
}De ce merge
Nume devine nume prin politica camelCase, iar [JsonPropertyName("nume")] dădea același nume și proprietății Denumire, deci tipul nu putea fi serializat. Cu [JsonPropertyName("denumireComerciala")], fiecare proprietate are cheia ei. Ordinea cheilor din răspuns urmează ordinea proprietăților din clasă. Numele C# al proprietății poate rămâne același.
Alte forme ale mesajului
System.InvalidOperationException: The JSON property name for 'Comanda.id' collides with another property.System.InvalidOperationException: The JSON property name for 'ProdusDto.pret_total' collides with another property.
Cum o eviți pe viitor
- Alege nume distincte pentru proprietățile DTO-urilor; nu păstra două proprietăți pentru același câmp.
- Folosește
[JsonIgnore]pentru proprietățile calculate sau de compatibilitate care nu trebuie trimise. - Acoperă fiecare DTO cu un test de serializare simplu.
- Revizuiește atributele
[JsonPropertyName]la code review.
Întrebări frecvente
De ce aplicația pornește, iar eroarea apare la cerere?
Metadatele de serializare se construiesc leneș, la prima folosire a tipului. Până atunci nimeni nu verifică numele.
Contează majusculele la coliziune?
La serializare se compară numele exacte, dar la citire System.Text.Json (cu opțiunile web) ignoră majusculele, deci și Id/ID produc conflict în ASP.NET Core.
Erori înrudite
System.Text.Json.JsonException: A possible object cycle was detected. This can either be due to a cycle or if the object depth is larger than the maximum allowed depth of 64. Consider using ReferenceHandler.Preserve on JsonSerializerOptions to support cycles. Obiectul întors are o referință circulară (de exemplu Categorie.Produse și Produs.Categorie, ca la entitățile EF Core), iar serializarea JSON intră în buclă până la adâncimea maximă 64. Întoarce un DTO fără referința înapoi sau setează ReferenceHandler.IgnoreCycles. System.NotSupportedException: Serialization and deserialization of 'System.Type' instances is not supported. Path: $.Tip. Obiectul întors conține o proprietate de tip System.Type (de exemplu GetType() sau o excepție întreagă), pe care System.Text.Json refuză să o serializeze din motive de securitate. Întoarce doar textul de care ai nevoie: GetType().Name sau un DTO cu câmpuri simple. 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. Î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.
