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`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Spre deosebire de „invalid start of a value”, aici textul e JSON corect. Problema e la potrivirea cu clasa C#: System.Text.Json a citit valoarea de la calea indicată ($.Varsta = proprietatea Varsta de la rădăcină; $.Produse[2].Pret = prețul celui de-al treilea produs) și nu a putut-o transforma în tipul cerut (System.Int32, System.Decimal, System.DateTime, List1[...]`).
Cauze frecvente:
- numere trimise ca texte (
"Varsta": "17");System.Text.Jsonnu le convertește implicit, spre deosebire de Newtonsoft.Json; - o valoare
nullpentru o proprietateint/decimal, care nu acceptănull; - un singur obiect sau text acolo unde clasa așteaptă o listă;
- date în alt format decât ISO 8601 (
"01.02.2026"pentruDateTime); - enum-uri trimise ca text fără
JsonStringEnumConverter.
Excepția internă (---> System.InvalidOperationException: Cannot get the value of a token type 'String' as a number.) îți spune tipul găsit de fapt.
De ce apare: cauzele frecvente
1Număr trimis ca text
using System.Text.Json;
var e = JsonSerializer.Deserialize<Elev>("{\"Varsta\":\"17\"}");
class Elev { public int Varsta { get; set; } }using System.Text.Json;
using System.Text.Json.Serialization;
var opt = new JsonSerializerOptions { NumberHandling = JsonNumberHandling.AllowReadingFromString };
var e = JsonSerializer.Deserialize<Elev>("{\"Varsta\":\"17\"}", opt);
class Elev { public int Varsta { get; set; } }Opțiunea permite citirea numerelor scrise între ghilimele.
2null pentru un tip valoare
using System.Text.Json;
var p = JsonSerializer.Deserialize<Produs>("{\"Stoc\":null}");
class Produs { public int Stoc { get; set; } }using System.Text.Json;
var p = JsonSerializer.Deserialize<Produs>("{\"Stoc\":null}");
class Produs { public int? Stoc { get; set; } }Un int nu poate fi null. Cu int?, valoarea lipsă e acceptată.
3Un singur text în loc de listă
using System.Text.Json;
var a = JsonSerializer.Deserialize<Articol>("{\"Tags\":\"csharp\"}");
class Articol { public List<string> Tags { get; set; } }using System.Text.Json;
var a = JsonSerializer.Deserialize<Articol>("{\"Tags\":[\"csharp\"]}");
class Articol { public List<string> Tags { get; set; } }Lista trebuie să vină ca tablou JSON ([...]). Dacă nu controlezi sursa, scrie un convertor propriu.
Repară eroarea, direct în pagină
Un API trimite prețurile produselor ca texte ("Pret":"12.50"), iar programul se oprește cu System.Text.Json.JsonException: The JSON value could not be converted to System.Decimal. Path: $[0].Pret. Fără să schimbi JSON-ul sau tipul decimal, configurează deserializarea, astfel încât programul să afișeze fiecare produs și totalul.
using System.Text.Json;
using System.Text.Json.Serialization;
string json = "[{\"Nume\":\"Mouse\",\"Pret\":\"12.50\"},{\"Nume\":\"Pad\",\"Pret\":\"7.25\"}]";
var produse = JsonSerializer.Deserialize<List<Produs>>(json);
foreach (var p in produse)
Console.WriteLine($"{p.Nume}: {p.Pret:F2}");
Console.WriteLine($"Total: {produse.Sum(p => p.Pret):F2}");
class Produs
{
public string Nume { get; set; }
public decimal Pret { get; set; }
}Mouse: 12.50 Pad: 7.25 Total: 19.75
Indiciu
JsonSerializerOptions are o setare NumberHandling pentru numere scrise între ghilimele.
Reparația
using System.Text.Json;
using System.Text.Json.Serialization;
string json = "[{\"Nume\":\"Mouse\",\"Pret\":\"12.50\"},{\"Nume\":\"Pad\",\"Pret\":\"7.25\"}]";
var optiuni = new JsonSerializerOptions { NumberHandling = JsonNumberHandling.AllowReadingFromString };
var produse = JsonSerializer.Deserialize<List<Produs>>(json, optiuni);
foreach (var p in produse)
Console.WriteLine($"{p.Nume}: {p.Pret:F2}");
Console.WriteLine($"Total: {produse.Sum(p => p.Pret):F2}");
class Produs
{
public string Nume { get; set; }
public decimal Pret { get; set; }
}De ce merge
Proprietatea Pret este decimal, dar în JSON valoarea era text ("12.50"), iar System.Text.Json nu face implicit această conversie. Cu NumberHandling = JsonNumberHandling.AllowReadingFromString, numerele dintre ghilimele sunt citite ca numere, deci lista se deserializează, iar totalul se calculează normal: 12.50 + 7.25 = 19.75.
Alte forme ale mesajului
System.Text.Json.JsonException: The JSON value could not be converted to System.Decimal. Path: $.Pret | LineNumber: 0 | BytePositionInLine: 16.System.Text.Json.JsonException: The JSON value could not be converted to System.Collections.Generic.List`1[System.String]. Path: $.Tags | LineNumber: 0 | BytePositionInLine: 12.
Cum o eviți pe viitor
- Pune tipurile proprietăților după formatul real al datelor; dacă sursa trimite numere ca text, folosește
JsonNumberHandling.AllowReadingFromString. - Folosește tipuri nullable (
int?,DateTime?) pentru câmpurile care pot lipsi. - Pentru enum-uri ca text, adaugă
new JsonStringEnumConverter()înConverters. - Ține un exemplu real de răspuns JSON lângă clasă și testează deserializarea pe el.
Întrebări frecvente
De ce cu Newtonsoft.Json mergea?
Newtonsoft.Json convertește implicit multe valori (de exemplu "17" în int). System.Text.Json e strict în mod implicit; flexibilitatea se activează prin opțiuni.
Cum citesc Path?
$ este rădăcina documentului, .Nume o proprietate, [2] al treilea element dintr-un tablou. $.Comenzi[0].Total = totalul primei comenzi.
Erori înrudite
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`. error CS0037: Cannot convert null to 'int' because it is a non-nullable value type Ai pus `null` într-o variabilă de tip valoare (`int`, `double`, `bool`, `DateTime`, `decimal`), care nu poate fi „goală”. Dacă valoarea poate lipsi, folosește tipul nullable: `int?`, `double?`, `DateTime?`. Altfel, dă o valoare implicită (de exemplu 0). 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`. Î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.
