System.Text.Json.JsonException: The JSON array contains a trailing comma at the end which is not supported in this mode. Change the reader options. Path: $.Servere[2] | LineNumber: 0 | BytePositionInLine: 37.
JSON-ul are o virgulă după ultimul element dintr-o listă sau dintr-un obiect (`["a", "b",]`). Standardul JSON nu o permite, iar `System.Text.Json` o refuză implicit. Șterge virgula sau, dacă fișierul e scris de oameni, activează `AllowTrailingCommas = true` în `JsonSerializerOptions`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
System.Text.Json respectă strict standardul JSON, în care virgula separă elementele și nu poate sta după ultimul. Fișierele de configurare scrise de mână, sau JSON copiat din cod JavaScript, au des o virgulă în plus. Rezultatul e JsonException: The JSON array contains a trailing comma at the end which is not supported in this mode. Change the reader options. (sau The JSON object contains a trailing comma... pentru obiecte).
Partea de după mesaj te duce la locul exact: Path: $.Servere[2] înseamnă proprietatea Servere, la poziția unde ar fi trebuit să fie al treilea element, iar LineNumber și BytePositionInLine sunt numărate de la 0.
Ai două reparații:
- corectezi JSON-ul (varianta potrivită pentru date schimbate între sisteme);
- îi spui serializatorului să fie tolerant:
new JsonSerializerOptions { AllowTrailingCommas = true }, potrivit pentru fișiere de configurare editate de oameni. Pentru comentarii (// ...) există șiReadCommentHandling = JsonCommentHandling.Skip.
Configurarea ASP.NET Core (appsettings.json) acceptă deja virgule finale și comentarii, deci eroarea apare de obicei când citești singur fișierul.
De ce apare: cauzele frecvente
1Virgulă după ultimul element dintr-o listă
{ "Servere": ["a", "b",] }{ "Servere": ["a", "b"] }Fără virgula finală, JSON-ul e valid pentru orice parser.
2Fișier de configurare editat de oameni
var cfg = JsonSerializer.Deserialize<Config>(text);var opt = new JsonSerializerOptions
{
AllowTrailingCommas = true,
ReadCommentHandling = JsonCommentHandling.Skip
};
var cfg = JsonSerializer.Deserialize<Config>(text, opt);Opțiunile acceptă virgule finale și comentarii.
3JSON construit prin concatenare
string json = "[";
foreach (var n in nume) json += $"\"{n}\",";
json += "]";string json = JsonSerializer.Serialize(nume);Serializatorul produce mereu JSON valid, fără virgule în plus.
Repară eroarea, direct în pagină
Programul citește configurarea dintr-un JSON scris de mână, dar se oprește cu System.Text.Json.JsonException: The JSON array contains a trailing comma at the end which is not supported in this mode. Fără să modifici textul JSON, repară citirea ca programul să afișeze Timeout: 30 și Servere: srv1, srv2.
using System.Text.Json;
string json = "{\"Timeout\": 30, \"Servere\": [\"srv1\", \"srv2\",],}";
var cfg = JsonSerializer.Deserialize<Config>(json);
Console.WriteLine($"Timeout: {cfg.Timeout}");
Console.WriteLine($"Servere: {string.Join(", ", cfg.Servere)}");
class Config
{
public int Timeout { get; set; }
public List<string> Servere { get; set; }
}Timeout: 30 Servere: srv1, srv2
Indiciu
JsonSerializerOptions are o opțiune pentru virgulele de la final.
Reparația
using System.Text.Json;
string json = "{\"Timeout\": 30, \"Servere\": [\"srv1\", \"srv2\",],}";
var optiuni = new JsonSerializerOptions { AllowTrailingCommas = true };
var cfg = JsonSerializer.Deserialize<Config>(json, optiuni);
Console.WriteLine($"Timeout: {cfg.Timeout}");
Console.WriteLine($"Servere: {string.Join(", ", cfg.Servere)}");
class Config
{
public int Timeout { get; set; }
public List<string> Servere { get; set; }
}De ce merge
JSON-ul are câte o virgulă după ultimul element din listă și din obiect, pe care System.Text.Json o refuză implicit. Cu AllowTrailingCommas = true, serializatorul le acceptă, deci obiectul Config se completează cu Timeout și lista de servere. Textul JSON a rămas neschimbat, cum cerea sarcina.
Alte forme ale mesajului
System.Text.Json.JsonException: The JSON object contains a trailing comma at the end which is not supported in this mode. Change the reader options. Path: $.a | LineNumber: 0 | BytePositionInLine: 7.
Cum o eviți pe viitor
- Generează JSON doar cu serializatorul, nu prin concatenare de text.
- Pentru fișierele de configurare citite de tine, folosește aceleași opțiuni tolerante peste tot (
AllowTrailingCommas,ReadCommentHandling). - Validează fișierele JSON scrise de mână cu editorul (VS Code marchează virgulele în plus).
Întrebări frecvente
De ce Newtonsoft.Json accepta virgula și System.Text.Json nu?
Newtonsoft.Json e tolerant implicit. System.Text.Json a fost gândit strict și rapid, iar toleranța se activează explicit prin opțiuni.
Ce înseamnă $ din Path?
$ e rădăcina documentului. $.Servere[2] înseamnă proprietatea Servere a obiectului rădăcină, elementul cu indexul 2.
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`. System.Text.Json.JsonException: '"' is invalid after a value. Expected either ',', '}', or ']'. Path: $ | LineNumber: 2 | BytePositionInLine: 0. JSON-ul are o problemă după o valoare: de cele mai multe ori lipsește o virgulă între două proprietăți sau elemente, ori există un comentariu (`//`) sau text în plus. Mesajul îți spune caracterul găsit și linia (numărată de la 0). Adaugă virgula lipsă sau, pentru comentarii, folosește `ReadCommentHandling = JsonCommentHandling.Skip`. 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`. Î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.
