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

System.InvalidOperationException: The JSON property name for 'Produs.nume' collides with another property.

Pe scurt

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

Greșit
C#
public class Produs
{
    public string Nume { get; set; } = "";
    [JsonPropertyName("nume")]
    public string Denumire { get; set; } = "";
}
Corect
C#
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

Greșit
C#
public string Nume { get; set; } = "";
[JsonPropertyName("nume")]
public string NumeVechi => Nume;
Corect
C#
public string Nume { get; set; } = "";
[JsonIgnore]
public string NumeVechi => Nume;

Dacă proprietatea nu trebuie să apară în JSON, [JsonIgnore] o scoate din serializare.

Repară tu

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.

Codul care dă eroarea
C#
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; }
}
După reparație, programul afișează
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.

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.

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