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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
System.Text.Json blochează explicit serializarea anumitor tipuri care nu au sens ca date și ar putea expune detalii interne: System.Type, MethodInfo, IntPtr, delegați și altele. Când ASP.NET Core încearcă să scrie răspunsul și dă peste o astfel de proprietate, aruncă NotSupportedException, cu calea câmpului ($.Tip), iar clientul primește 500.
Cel mai des se întâmplă când întorci din endpoint obiecte „de diagnostic”: o excepție întreagă (Exception are TargetSite, de tip MethodBase), un obiect anonim cu x.GetType() sau metadate de reflecție. Soluția e să trimiți doar informația text: GetType().Name, ex.Message, sau un ProblemDetails. Pe lângă eroare, e și o chestiune de securitate: stack trace-urile și tipurile interne nu trebuie să ajungă la client.
De ce apare: cauzele frecvente
1Tipul obiectului în răspuns
app.MapGet("/plati/{id:int}", (int id) => new { Id = id, Tip = plata.GetType() });app.MapGet("/plati/{id:int}", (int id) => new { Id = id, Tip = plata.GetType().Name });Numele tipului este un string, care se serializează normal.
2Excepția întreagă întoarsă clientului
catch (Exception ex)
{
return Results.Json(ex, statusCode: 500);
}catch (Exception ex)
{
return Results.Problem(detail: ex.Message, statusCode: 500);
}Exception conține TargetSite (reflecție) și stack trace; ProblemDetails trimite doar ce trebuie.
Repară eroarea, direct în pagină
Endpoint-ul de diagnostic GET /plati/1 răspunde 500: Serialization and deserialization of 'System.Type' instances is not supported. Path: $.Tip.. Repară răspunsul ca să conțină numele tipului plății: {"id":1,"suma":250,"tip":"PlataCard"}.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var plati = new List<Plata> { new PlataCard(1, 250m), new PlataTransfer(2, 1200m) };
app.MapGet("/plati/{id:int}", (int id) =>
{
var plata = plati.First(p => p.Id == id);
return new { plata.Id, plata.Suma, Tip = plata.GetType() };
});
app.Run();
public abstract record Plata(int Id, decimal Suma);
public record PlataCard(int Id, decimal Suma) : Plata(Id, Suma);
public record PlataTransfer(int Id, decimal Suma) : Plata(Id, Suma);GET /plati/1 → 200 OK
{"id":1,"suma":250,"tip":"PlataCard"}
GET /plati/2 → 200 OK
{"id":2,"suma":1200,"tip":"PlataTransfer"}Indiciu
Clientul are nevoie doar de numele tipului, ca text.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var plati = new List<Plata> { new PlataCard(1, 250m), new PlataTransfer(2, 1200m) };
app.MapGet("/plati/{id:int}", (int id) =>
{
var plata = plati.First(p => p.Id == id);
return new { plata.Id, plata.Suma, Tip = plata.GetType().Name };
});
app.Run();
public abstract record Plata(int Id, decimal Suma);
public record PlataCard(int Id, decimal Suma) : Plata(Id, Suma);
public record PlataTransfer(int Id, decimal Suma) : Plata(Id, Suma);De ce merge
Proprietatea Tip conținea obiectul System.Type, pe care System.Text.Json îl refuză. plata.GetType().Name întoarce un string (PlataCard), serializat normal. Numele proprietății din obiectul anonim devine tip în JSON, datorită politicii camelCase implicite. Același principiu se aplică excepțiilor: trimite mesajul, nu obiectul. Detaliile tehnice rămân în loguri, pe server.
Alte forme ale mesajului
System.NotSupportedException: Serialization and deserialization of 'System.Reflection.MethodBase' instances is not supported. Path: $.TargetSite.System.NotSupportedException: Serialization and deserialization of 'System.IntPtr' instances is not supported. Path: $.Handle.System.NotSupportedException: Serialization and deserialization of 'System.Action' instances is not supported.
Cum o eviți pe viitor
- Întoarce din API doar DTO-uri cu tipuri simple (string, numere, date, liste, obiecte proprii).
- Pentru erori folosește
ProblemDetails(Results.Problem), nu obiectul excepției. - Nu pune obiecte de infrastructură (
HttpContext,DbContext,Type) în modelele de răspuns. - Loghează detaliile tehnice pe server, nu în răspuns.
Întrebări frecvente
De ce nu pot serializa Type?
Deserializarea unui tip arbitrar dintr-un JSON primit ar permite unui atacator să ceară crearea oricărei clase din aplicație. System.Text.Json blochează tipul în ambele direcții, ca să nu existe această capcană.
Cu Newtonsoft.Json mergea. De ce?
Newtonsoft scrie Type ca nume de tip, dar a avut vulnerabilități tocmai legate de TypeNameHandling. System.Text.Json a ales să-l refuze explicit.
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.ArgumentException: .NET number values such as positive and negative infinity cannot be written as valid JSON. Răspunsul conține un double sau float cu valoarea NaN sau Infinity (de exemplu o medie calculată ca 0.0 / 0), iar JSON nu are reprezentare pentru ele, deci serializarea aruncă excepția și clientul primește 500. Tratează cazul fără date înainte de împărțire sau folosește decimal. 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. Î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.
