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

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.

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Când întorci un obiect dintr-un endpoint, ASP.NET Core îl serializează cu System.Text.Json, urmărind toate proprietățile. Dacă o categorie are lista de produse, iar fiecare produs are înapoi proprietatea Categorie, serializatorul scrie categoria, apoi produsul, apoi din nou categoria și tot așa. Implicit nu detectează ciclurile, așa că se oprește când adâncimea depășește 64 și aruncă excepția; răspunsul devine 500 (uneori după ce o parte din JSON a fost deja trimisă).

Cazul tipic sunt entitățile EF Core cu navigări în ambele sensuri, încărcate cu Include. Partea Path: $.Produse.Categorie.Produse... din mesaj arată exact bucla. Soluția recomandată este să nu expui entitățile direct, ci DTO-uri care conțin doar ce trebuie clientului. Opțiunea ReferenceHandler.IgnoreCycles scrie null în locul referinței repetate.

De ce apare: cauzele frecvente

1Entități cu navigări în ambele sensuri

Greșit
C#
app.MapGet("/categorii", (MagazinDb db) =>
    db.Categorii.Include(c => c.Produse).ToList());
Corect
C#
app.MapGet("/categorii", (MagazinDb db) =>
    db.Categorii.Select(c => new CategorieDto(c.Nume, c.Produse.Select(p => p.Nume).ToList())).ToList());

DTO-ul nu are referința înapoi spre categorie, deci nu există ciclu.

2Fără DTO: ignoră ciclurile la serializare

Greșit
C#
var app = builder.Build();
Corect
C#
builder.Services.ConfigureHttpJsonOptions(o =>
    o.SerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles);
var app = builder.Build();

IgnoreCycles (din System.Text.Json.Serialization) scrie null acolo unde ar reapărea un obiect deja în curs de scriere.

Repară tu

Repară eroarea, direct în pagină

GET /categorii răspunde 500: A possible object cycle was detected..., pentru că fiecare produs are referință înapoi la categoria lui. Repară endpoint-ul ca să întoarcă un DTO: pentru fiecare categorie, numele și lista numelor produselor.

Codul care dă eroarea
C#
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var it = new Categorie { Nume = "IT" };
it.Produse.Add(new Produs { Nume = "Mouse", Categorie = it });
it.Produse.Add(new Produs { Nume = "Laptop", Categorie = it });
var categorii = new List<Categorie> { it };

app.MapGet("/categorii", () => categorii);

app.Run();

public class Categorie
{
    public string Nume { get; set; } = "";
    public List<Produs> Produse { get; } = new();
}

public class Produs
{
    public string Nume { get; set; } = "";
    public Categorie? Categorie { get; set; }
}

public record CategorieDto(string Nume, List<string> Produse);
După reparație, programul afișează
GET /categorii → 200 OK
[{"nume":"IT","produse":["Mouse","Laptop"]}]
Indiciu

Construiește cu Select obiecte noi care nu conțin referința de la produs la categorie.

Alte forme ale mesajului

  • 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. Path: $.Produse.Categorie.Produse.Categorie.Produse.Categorie.Nume.

Cum o eviți pe viitor

  • Nu întoarce entitățile EF Core direct din API: proiectează în DTO-uri cu Select.
  • Dacă ai nevoie de navigarea înapoi doar în cod, marchează-o cu [JsonIgnore] pe entitate.
  • Evită ReferenceHandler.Preserve în API-urile publice: adaugă $id/$ref în JSON, pe care puțini clienți îl înțeleg.

Întrebări frecvente

De ce nu am eroarea fără Include?

Fără Include, colecția Produse e goală (nu e încărcată), deci nu există ciclu în memorie. Ciclul apare când ambele capete sunt încărcate.

IgnoreCycles sau Preserve?

IgnoreCycles păstrează JSON-ul simplu și pune null la referința repetată. Preserve păstrează referințele cu $id și $ref, util doar dacă și clientul folosește System.Text.Json cu aceeași opțiune.

Erori înrudite

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