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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul spune că la poziția indicată (LineNumber, BytePositionInLine, ambele de la 0) cititorul JSON a găsit un caracter care nu poate începe nicio valoare JSON. O valoare validă începe cu {, [, ", o cifră, -, t(rue), f(alse) sau n(ull). Dacă primul caracter e M, ai dat textul Mouse fără ghilimele; dacă e <, ai primit HTML (des: o pagină de eroare a unui server sau proxy); dacă e ', ghilimele simple.
În ASP.NET Core apare în două locuri: ca excepție interioară la binding (corp cu Content-Type: application/json, dar conținut text) și în codul tău care face JsonSerializer.Deserialize pe date citite din cache, din configurare sau de la alt API. Al doilea caz dă 500, pentru că excepția nu e prinsă.
De ce apare: cauzele frecvente
1Text salvat fără serializare, citit cu Deserialize
cache["ultimul"] = produs.Nume;
// ...
var nume = JsonSerializer.Deserialize<string>(cache["ultimul"]);cache["ultimul"] = JsonSerializer.Serialize(produs.Nume);
// ...
var nume = JsonSerializer.Deserialize<string>(cache["ultimul"]);Serialize pune textul între ghilimele ("Mouse"), deci devine JSON valid.
2Răspuns HTML de la alt serviciu
var json = await raspuns.Content.ReadAsStringAsync();
var curs = JsonSerializer.Deserialize<Curs>(json);raspuns.EnsureSuccessStatusCode();
var curs = await raspuns.Content.ReadFromJsonAsync<Curs>();Un 404 sau 502 vine des cu o pagină HTML (<). Verifică statusul înainte să deserializezi.
3Corp text cu antet JSON
POST /note
Content-Type: application/json
Cumpără laptePOST /note
Content-Type: application/json
{"text":"Cumpără lapte"}Antetul promite JSON; conținutul trebuie să-l respecte.
Repară eroarea, direct în pagină
Un cache simplu păstrează ultimul produs vizualizat ca JSON, dar GET /ultimul răspunde 500: JsonException: 'M' is an invalid start of a value.. Repară salvarea (nu citirea), astfel încât după POST /vizualizari/Mouse cererea GET /ultimul să întoarcă Ultimul produs: Mouse.
using System.Text.Json;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var cache = new Dictionary<string, string>();
app.MapPost("/vizualizari/{produs}", (string produs) =>
{
cache["ultimul"] = produs;
return Results.NoContent();
});
app.MapGet("/ultimul", () =>
{
var produs = JsonSerializer.Deserialize<string>(cache["ultimul"]);
return $"Ultimul produs: {produs}";
});
app.Run();POST /vizualizari/Mouse → 204 No Content GET /ultimul → 200 OK Ultimul produs: Mouse
Indiciu
Ce scrii în cache trebuie să fie JSON valid, adică produs de serializator.
Reparația
using System.Text.Json;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var cache = new Dictionary<string, string>();
app.MapPost("/vizualizari/{produs}", (string produs) =>
{
cache["ultimul"] = JsonSerializer.Serialize(produs);
return Results.NoContent();
});
app.MapGet("/ultimul", () =>
{
var produs = JsonSerializer.Deserialize<string>(cache["ultimul"]);
return $"Ultimul produs: {produs}";
});
app.Run();De ce merge
Endpoint-ul de vizualizare punea în cache textul brut Mouse, iar citirea făcea JsonSerializer.Deserialize<string>, care așteaptă JSON. Un string JSON are ghilimele: "Mouse". JsonSerializer.Serialize(produs) la salvare produce exact forma așteptată, iar citirea și scrierea devin simetrice. Pentru valori simple poți salva și textul brut, dar atunci nici citirea nu trebuie să folosească Deserialize.
Alte forme ale mesajului
System.Text.Json.JsonException: '<' is an invalid start of a value. Path: $ | LineNumber: 0 | BytePositionInLine: 0.System.Text.Json.JsonException: ''' is an invalid start of a property name. Expected a '"'. Path: $ | LineNumber: 0 | BytePositionInLine: 2.System.Text.Json.JsonException: 'n' is an invalid start of a property name. Expected a '"'. Path: $ | LineNumber: 0 | BytePositionInLine: 2.
Cum o eviți pe viitor
- Scrie și citește datele JSON simetric:
Serializela salvare,Deserializela citire. - Verifică statusul și
Content-Typeal răspunsurilor externe înainte de deserializare. - Loghează primele caractere ale textului primit când deserializarea eșuează: un
<spune imediat că e HTML.
Întrebări frecvente
Ce înseamnă BytePositionInLine: 0?
Că problema e la primul caracter. Dacă poziția e mai mare, JSON-ul începe corect, dar are o greșeală mai încolo (de exemplu o virgulă în plus).
Newtonsoft.Json acceptă textul ăsta?
Nici el nu acceptă un text fără ghilimele ca valoare JSON. E mai permisiv la ghilimele simple și comentarii, dar System.Text.Json e standardul în ASP.NET Core.
Erori înrudite
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: The JSON value could not be converted to Stare. Path: $.stare | LineNumber: 0 | BytePositionInLine: 35. System.Text.Json nu poate pune valoarea din JSON în tipul proprietății: cel mai des un enum trimis ca text ("Livrata") fără JsonStringEnumConverter, sau un text într-un număr. Adaugă convertorul pentru enum-uri sau corectează tipul. Path arată câmpul. 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. Î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.
