...
Eroare C# · Excepții la rulare: null, conversii, aritmetică

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

Pe scurt

Textul dat lui `JsonSerializer.Deserialize` nu este JSON valid. Caracterul dintre apostrofuri e primul lucru greșit: `'<'` înseamnă de obicei că ai primit o pagină HTML (o eroare a serverului), iar `'''` că valorile sunt între apostrofuri în loc de ghilimele. Verifică textul înainte și tratează `JsonException`.

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

Ce înseamnă

JSON are reguli stricte: textele și numele proprietăților stau între ghilimele duble, fără virgule la final, fără comentarii. Când System.Text.Json citește un caracter care nu poate începe o valoare JSON, aruncă JsonException și îți spune exact ce caracter a găsit și unde: Path: $ (rădăcina documentului) sau $.Nume (proprietatea), plus linia și poziția în octeți.

Cum interpretezi caracterul:

  • '<': textul e HTML sau XML, de exemplu pagina de eroare 404/500 a unui server sau un proxy care a cerut autentificare;
  • ''': valori între apostrofuri ({"nume": 'Pix'});
  • o literă ('a', 'N'): text simplu, NaN sau un mesaj de eroare în loc de JSON;
  • „The input does not contain any JSON tokens”: textul e gol.

În practică, la un API, verifică întâi codul de stare HTTP și tipul conținutului înainte să deserializezi, iar parsarea pune-o într-un try/catch (JsonException).

De ce apare: cauzele frecvente

1Răspuns HTML în loc de JSON

Greșit
C#
using System.Text.Json;
string raspuns = "<html>500 Internal Server Error</html>";
var p = JsonSerializer.Deserialize<Produs>(raspuns);
class Produs { public string Nume { get; set; } }
Corect
C#
using System.Text.Json;
string raspuns = "<html>500 Internal Server Error</html>";
try { var p = JsonSerializer.Deserialize<Produs>(raspuns); }
catch (JsonException) { Console.WriteLine("Raspuns invalid de la server"); }
class Produs { public string Nume { get; set; } }

Serverul a trimis o pagină de eroare. Programul trebuie să trateze situația, nu să se oprească.

2Text între apostrofuri

Greșit
C#
using System.Text.Json;
var p = JsonSerializer.Deserialize<Produs>("{\"Nume\": 'Pix'}");
class Produs { public string Nume { get; set; } }
Corect
C#
using System.Text.Json;
var p = JsonSerializer.Deserialize<Produs>("{\"Nume\": \"Pix\"}");
class Produs { public string Nume { get; set; } }

În JSON, textele se scriu doar între ghilimele duble.

3JSON construit de mână

Greșit
C#
using System.Text.Json;
string nume = "Pix";
string json = "{\"Nume\": " + nume + "}";
var p = JsonSerializer.Deserialize<Produs>(json);
class Produs { public string Nume { get; set; } }
Corect
C#
using System.Text.Json;
string nume = "Pix";
string json = JsonSerializer.Serialize(new Produs { Nume = nume });
var p = JsonSerializer.Deserialize<Produs>(json);
class Produs { public string Nume { get; set; } }

Concatenarea a produs {"Nume": Pix}, fără ghilimele. Serialize generează mereu JSON corect.

Repară tu

Repară eroarea, direct în pagină

Programul procesează trei răspunsuri primite de la un API de produse, dar se oprește cu System.Text.Json.JsonException: '<' is an invalid start of a value. Al doilea răspuns este o pagină de eroare HTML. Repară programul, astfel încât răspunsurile valide să fie afișate, iar pentru cel invalid să apară „raspuns invalid”.

Codul care dă eroarea
C#
using System.Text.Json;

string[] raspunsuri =
{
    "{\"Nume\":\"Pix\",\"Pret\":3.5}",
    "<html><body>502 Bad Gateway</body></html>",
    "{\"Nume\":\"Caiet\",\"Pret\":7}"
};

foreach (string r in raspunsuri)
{
    var p = JsonSerializer.Deserialize<Produs>(r);
    Console.WriteLine($"{p.Nume}: {p.Pret} lei");
}

class Produs
{
    public string Nume { get; set; }
    public decimal Pret { get; set; }
}
După reparație, programul afișează
Pix: 3.5 lei
raspuns invalid
Caiet: 7 lei
Indiciu

Prinde JsonException în jurul apelului Deserialize.

Alte forme ale mesajului

  • System.Text.Json.JsonException: ''' is an invalid start of a value. Path: $.Nume | LineNumber: 0 | BytePositionInLine: 9.
  • System.Text.Json.JsonException: 'n' is an invalid start of a property name. Expected a '"'. Path: $ | LineNumber: 0 | BytePositionInLine: 1.
  • System.Text.Json.JsonException: The input does not contain any JSON tokens. Expected the input to start with a valid JSON token, when isFinalBlock is true. Path: $ | LineNumber: 0 | BytePositionInLine: 0.

Cum o eviți pe viitor

  • Nu construi JSON prin concatenare de texte; folosește JsonSerializer.Serialize.
  • La apelurile HTTP, verifică response.IsSuccessStatusCode și tipul conținutului înainte de deserializare.
  • Pune Deserialize într-un try/catch (JsonException ex) și loghează primele caractere ale textului primit, ca să vezi ce a venit de fapt.
  • Validează fișierele JSON scrise de mână cu un validator sau cu editorul (VS Code subliniază greșelile).

Întrebări frecvente

De ce exact '<'?

Pentru că aproape orice pagină HTML începe cu < (<!DOCTYPE html>, <html>). E semnul clasic că URL-ul, autentificarea sau serverul au întors o pagină în loc de date.

Ce înseamnă BytePositionInLine?

Poziția, în octeți, a caracterului problematic pe linia indicată (numărând de la 0). Te ajută să găsești locul exact într-un JSON lung.

Erori înrudite

← Toate erorile C#

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ță C# de la zero, cu exerciții la fiecare lecție

Curs C#: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.