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

System.InvalidOperationException: Unable to read the request as JSON because the request content type 'text/plain; charset=utf-8' is not a known JSON content type.

Pe scurt

Ai apelat Request.ReadFromJsonAsync<T>() pe o cerere al cărei Content-Type nu e JSON. Metoda aruncă excepția (500), în loc de 415. Verifică întâi request.HasJsonContentType() și întoarce 415, sau lasă Minimal APIs să lege parametrul din corp.

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

Ce înseamnă

HttpRequest.ReadFromJsonAsync<T>() este metoda pe care o folosești când citești corpul manual (în middleware, în handlere care primesc HttpRequest sau HttpContext). Spre deosebire de binding-ul automat, care răspunde singur cu 415 la un Content-Type greșit, metoda aruncă InvalidOperationException dacă antetul nu e application/json sau compatibil (+json). Excepția neprinsă devine 500, deci clientul crede că serverul are o problemă, deși cererea lui e greșită.

Partea din apostrofuri arată tipul primit: text/plain; charset=utf-8 (un string trimis fără tip), application/x-www-form-urlencoded (formular, curl -d), multipart/form-data (upload) sau gol (fără antet). Ca reparație, verifici întâi request.HasJsonContentType() și răspunzi 415, sau renunți la citirea manuală și declari parametrul tipat în handler.

De ce apare: cauzele frecvente

1Citire manuală fără verificarea antetului

Greșit
C#
app.MapPost("/note", async (HttpRequest req) =>
{
    var nota = await req.ReadFromJsonAsync<Nota>();
    return Results.Ok(nota);
});
Corect
C#
app.MapPost("/note", async (HttpRequest req) =>
{
    if (!req.HasJsonContentType())
        return Results.StatusCode(StatusCodes.Status415UnsupportedMediaType);
    var nota = await req.ReadFromJsonAsync<Nota>();
    return Results.Ok(nota);
});

Cererile care nu sunt JSON primesc 415, cum se cuvine, în loc de excepție.

2Citire manuală inutilă

Greșit
C#
app.MapPost("/note", async (HttpContext ctx) =>
    Results.Ok(await ctx.Request.ReadFromJsonAsync<Nota>()));
Corect
C#
app.MapPost("/note", (Nota nota) => Results.Ok(nota));

Binding-ul automat verifică Content-Type, citește JSON-ul și răspunde 415/400 la probleme.

Repară tu

Repară eroarea, direct în pagină

Webhook-ul POST /note citește corpul cu ReadFromJsonAsync. Cererea JSON merge, dar cea cu text simplu răspunde 500: Unable to read the request as JSON because the request content type 'text/plain; charset=utf-8' is not a known JSON content type.. Repară handler-ul ca cererile care nu sunt JSON să primească 415 Unsupported Media Type.

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

app.MapPost("/note", async (HttpRequest req) =>
{
    var nota = await req.ReadFromJsonAsync<Nota>();
    return Results.Ok(nota);
});

app.Run();

public record Nota(string Text);
După reparație, programul afișează
POST /note → 200 OK
{"text":"Cumpără lapte"}
POST /note → 415 Unsupported Media Type
Indiciu

Există o metodă pe HttpRequest care îți spune dacă antetul cererii e de tip JSON.

Alte forme ale mesajului

  • System.InvalidOperationException: Unable to read the request as JSON because the request content type 'application/x-www-form-urlencoded' is not a known JSON content type.
  • System.InvalidOperationException: Unable to read the request as JSON because the request content type '' is not a known JSON content type.

Cum o eviți pe viitor

  • Preferă parametrii tipați în handlere în locul citirii manuale a corpului.
  • Când citești manual (middleware, webhook-uri), verifică HasJsonContentType() și răspunde 415.
  • Prinde excepțiile de format într-un IExceptionHandler comun, ca greșelile clientului să nu apară ca 500.
  • Testează webhook-urile și cu un Content-Type greșit.

Întrebări frecvente

Ce tipuri consideră „JSON” HasJsonContentType?

application/json și orice tip cu sufixul +json (de exemplu application/problem+json), cu sau fără charset.

De ce binding-ul dă 415, iar metoda aruncă excepție?

Binding-ul face parte din framework și știe să traducă problema în status HTTP. ReadFromJsonAsync e o metodă de nivel jos: semnalează problema prin excepție și te lasă pe tine să alegi răspunsul.

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.