System.Text.Json.JsonException: '<' is an invalid start of a value. Path: $ | LineNumber: 0 | BytePositionInLine: 0.
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,NaNsau 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
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; } }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
using System.Text.Json;
var p = JsonSerializer.Deserialize<Produs>("{\"Nume\": 'Pix'}");
class Produs { public string Nume { get; set; } }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ă
using System.Text.Json;
string nume = "Pix";
string json = "{\"Nume\": " + nume + "}";
var p = JsonSerializer.Deserialize<Produs>(json);
class Produs { public string Nume { get; set; } }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ă 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”.
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; }
}Pix: 3.5 lei raspuns invalid Caiet: 7 lei
Indiciu
Prinde JsonException în jurul apelului Deserialize.
Reparația
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)
{
try
{
var p = JsonSerializer.Deserialize<Produs>(r);
Console.WriteLine($"{p.Nume}: {p.Pret} lei");
}
catch (JsonException)
{
Console.WriteLine("raspuns invalid");
}
}
class Produs
{
public string Nume { get; set; }
public decimal Pret { get; set; }
}De ce merge
Al doilea text nu era JSON, ci HTML, iar < nu poate începe o valoare JSON, de aceea Deserialize arunca JsonException. Cu try/catch (JsonException) în jurul deserializării, răspunsul stricat e tratat local: se afișează „raspuns invalid”, iar bucla continuă cu următorul. Răspunsurile valide sunt citite normal.
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-untry/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
System.Text.Json.JsonException: The JSON value could not be converted to System.Int32. Path: $.Varsta | LineNumber: 0 | BytePositionInLine: 27. JSON-ul e valid, dar o valoare nu se potrivește cu tipul proprietății din clasa ta. `Path: $.Varsta` arată proprietatea: de exemplu numărul vine ca text (`"17"`) sau un obiect vine în loc de listă. Schimbă tipul proprietății sau activează `NumberHandling = JsonNumberHandling.AllowReadingFromString`. System.FormatException: The input string 'abc' was not in a correct format. `int.Parse` (sau `double.Parse`, `Convert.ToInt32`) a primit un text care nu este un număr valid: litere, șir gol, zecimale într-un `int`. Folosește `int.TryParse(text, out int n)` și tratează cazul în care întoarce `false`. System.ArgumentNullException: Value cannot be null. (Parameter 'source') Ai trimis `null` unei metode care nu-l acceptă. Numele din paranteză (`'source'`, `'key'`, `'s'`) e parametrul care a primit `null`: `source` înseamnă de obicei o colecție `null` folosită cu LINQ. Asigură-te că valoarea există (inițializează colecția, verifică înainte) sau tratează lipsa ei. Î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.
