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

System.Text.Json.JsonException: 'M' is an invalid start of a value. Path: $ | LineNumber: 0 | BytePositionInLine: 0.

Pe scurt

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

Greșit
C#
cache["ultimul"] = produs.Nume;
// ...
var nume = JsonSerializer.Deserialize<string>(cache["ultimul"]);
Corect
C#
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

Greșit
C#
var json = await raspuns.Content.ReadAsStringAsync();
var curs = JsonSerializer.Deserialize<Curs>(json);
Corect
C#
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

Greșit
C#
POST /note
Content-Type: application/json

Cumpără lapte
Corect
C#
POST /note
Content-Type: application/json

{"text":"Cumpără lapte"}

Antetul promite JSON; conținutul trebuie să-l respecte.

Repară tu

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.

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

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: Serialize la salvare, Deserialize la citire.
  • Verifică statusul și Content-Type al 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

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