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

System.NotSupportedException: Serialization and deserialization of 'System.Type' instances is not supported. Path: $.Tip.

Pe scurt

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

Greșit
C#
app.MapGet("/plati/{id:int}", (int id) => new { Id = id, Tip = plata.GetType() });
Corect
C#
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

Greșit
C#
catch (Exception ex)
{
    return Results.Json(ex, statusCode: 500);
}
Corect
C#
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ă tu

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"}.

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

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

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