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.
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
app.MapPost("/note", async (HttpRequest req) =>
{
var nota = await req.ReadFromJsonAsync<Nota>();
return Results.Ok(nota);
});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ă
app.MapPost("/note", async (HttpContext ctx) =>
Results.Ok(await ctx.Request.ReadFromJsonAsync<Nota>()));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ă 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.
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);POST /note → 200 OK
{"text":"Cumpără lapte"}
POST /note → 415 Unsupported Media TypeIndiciu
Există o metodă pe HttpRequest care îți spune dacă antetul cererii e de tip JSON.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapPost("/note", async (HttpRequest req) =>
{
if (!req.HasJsonContentType())
return Results.StatusCode(StatusCodes.Status415UnsupportedMediaType);
var nota = await req.ReadFromJsonAsync<Nota>();
return Results.Ok(nota);
});
app.Run();
public record Nota(string Text);De ce merge
ReadFromJsonAsync arunca excepție pentru orice Content-Type care nu e JSON, iar excepția neprinsă devenea 500. Verificarea req.HasJsonContentType() la început trimite 415 pentru cererile greșite, fără să încerce citirea. Cererea JSON trece mai departe și e citită ca înainte. Clientul află astfel corect că problema e la el.
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
IExceptionHandlercomun, ca greșelile clientului să nu apară ca 500. - Testează webhook-urile și cu un
Content-Typegreș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
415 Unsupported Media Type Endpoint-ul așteaptă JSON, dar cererea a venit cu alt Content-Type (text/plain, form, XML sau fără antet). Trimite corpul cu Content-Type: application/json, de exemplu cu PostAsJsonAsync sau new StringContent(json, Encoding.UTF8, "application/json"). Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to read parameter "Produs p" from the request body as JSON. Corpul cererii nu a putut fi deserializat în tipul parametrului: JSON invalid, o valoare de alt tip (1.5 într-un int, text într-un număr) sau un tablou în loc de obiect. Corectează datele trimise sau tipul proprietății, astfel încât să corespundă. System.Text.Json.JsonException: 'M' is an invalid start of a value. Path: $ | LineNumber: 0 | BytePositionInLine: 0. Textul dat lui System.Text.Json nu este JSON: începe cu o literă (un text simplu, HTML, un mesaj de eroare) în loc de {, [, " sau un număr. Verifică ce deserializezi; dacă ai salvat un text, salvează-l cu JsonSerializer.Serialize ca să fie JSON valid. Î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.
