Die JSON-Fehler hinter den meisten Parse-Fehlern und wie du sie behebst

Die meisten JSON-Parse-Fehler gehen auf eine kurze Liste typischer Fehler zurück: ein überflüssiges Komma am Ende, ein Text in einfachen Anführungszeichen, ein Kommentar, ein Schlüssel ohne Anführungszeichen, ein Wert wie NaN oder undefined oder typografische Anführungszeichen aus einem Dokument. JSON ist strenger als das JavaScript, dem es ähnelt. Code, der für dich richtig aussieht, kann deshalb vom Parser abgelehnt werden. Die Fehlermeldung nennt eine Zeile und eine Spalte, und die Korrektur liegt meist an dieser Stelle oder direkt davor.

JSON formatierenJSON wird nicht akzeptiertKostenlos loslegen

Die Regeln, die JSON durchsetzt

Ein JSON-Dokument ist genau ein Wert: ein Objekt in geschweiften Klammern, ein Array in eckigen Klammern, ein Text, eine Zahl, true, false oder null. Innerhalb dieser Werte gilt:

• Jeder Schlüssel und jeder Text steht in geraden doppelten Anführungszeichen, zum Beispiel "name".
• Kommas trennen die Elemente. Nach dem letzten Element eines Objekts oder Arrays darf kein Komma stehen.
• Zahlen dürfen kein führendes Plus haben. NaN, Infinity und undefined sind keine gültigen Zahlen oder Werte.
• Kommentare sind überhaupt nicht erlaubt.
• Schlüssel müssen Texte sein. Ein Schlüssel ohne Anführungszeichen wie name: ist deshalb ungültig.

Manche Parser akzeptieren einige dieser Abweichungen standardmäßig, und manche Werkzeuge verarbeiten JSON mit Kommentaren als Komfortfunktion. Diese Nachsicht verbirgt das Problem, bis die Datei an einen strengeren Leser gelangt. Schreibe deshalb von Anfang an die strikte Form.

Die Fehlermeldung lesen

Parser melden die erste Stelle, an der sie nicht weitermachen können. Die Meldung beschreibt das Problem und nennt eine Position, meist Zeile und Spalte. Hier ist eine kleine Datei mit einem überflüssigen Komma im Array und einem weiteren nach der letzten Eigenschaft:

{
  "name": "Ada",
  "tags": ["a", "b",],
}

Python meldet dafür: „Illegal trailing comma before end of array: line 3 column 20“. Der Wortlaut unterscheidet sich je nach Werkzeug, und ältere Parser nennen manchmal nur „Unexpected token“ mit einem Zeichen-Offset. Gehe zur gemeldeten Position und sieh dir das Zeichen direkt davor an. Der eigentliche Fehler ist oft ein Komma, ein Anführungszeichen oder eine Klammer ein bis zwei Zeichen davor.

Ein paar weitere Meldungen aus dem Parser von Python und was sie meist bedeuten:

• „Expecting property name enclosed in double quotes“ bei '{'a': 1}' bedeutet einen Schlüssel in einfachen oder ohne Anführungszeichen.
• „Expecting value“ an einer Stelle, an der du eine Zahl oder einen Text erwartest, deutet oft auf ein typografisches Anführungszeichen hin, denn der Parser sieht darin ein unbekanntes Zeichen.
• „Expecting ',' delimiter“ bedeutet meist ein fehlendes Komma zwischen zwei Elementen oder einen Kommentar mitten in den Daten.

Typografische Anführungszeichen und kopierter Text

Typografische Anführungszeichen verwirren am meisten, weil sie fast genauso aussehen wie gerade. Eine JSON-Datei, die aus einem Textverarbeitungsprogramm, einer Webseite oder einer Chatnachricht kopiert wurde, kann gebogene doppelte Anführungszeichen enthalten. Die Datei sieht für dich richtig aus und lässt sich trotzdem nicht parsen, weil der Parser „x“ als unbekanntes Zeichen liest und nicht als Begrenzung eines Textes.

Versteckte Zeichen verursachen denselben Fehler. Ein geschütztes Leerzeichen zwischen zwei Werten ist für den Parser kein Leerraum. Entferne unsichtbare Zeichen, bevor du die Struktur von Hand reparierst, und korrigiere danach die Anführungszeichen. Der Leitfaden zu typografischen Anführungszeichen zeigt, wie du sie sicher geradestellst.

Einfache Anführungszeichen, Kommentare und Schlüssel ohne Anführungszeichen

Viele Entwickler schreiben JSON-ähnliche Daten in einer Sprache, die mehr erlaubt:

• Einfache Anführungszeichen sind in JavaScript- und Python-Literalen gültig, JSON verlangt aber doppelte. Ersetze {'a': 1} durch {"a": 1}.
• Kommentare wie // oder /* */ müssen entfernt werden. Wenn du Notizen brauchst, lege sie in ein eigenes Feld oder verwende ein Format, das für Konfigurationsdateien gedacht ist.
• Schlüssel ohne Anführungszeichen sind in JavaScript-Objektliteralen üblich. Setze die Anführungszeichen ergänzend.
• NaN und undefined gibt es in JSON nicht. Verwende null für einen fehlenden Wert oder einen Text, wenn der Wert Text ist.

Sei vorsichtig beim pauschalen Suchen und Ersetzen. Wenn du jedes einfache Anführungszeichen durch ein doppeltes ersetzt, werden alle Texte mit einem Apostroph kaputt, zum Beispiel „Ada's notes“. Prüfe deshalb zuerst jeden Treffer unter Text suchen und ersetzen, damit du siehst, welche Anführungszeichen sich ändern würden.

Die Struktur Schritt für Schritt reparieren

1. Füge die Datei in JSON formatieren ein. Das Formatieren macht die Struktur sichtbar, und der Fehler zeigt Zeile und Spalte. Drücke danach auf Repair. Das entfernt Kommentare und überflüssige Kommas am Ende. Einfache und typografische Anführungszeichen ändert es nicht, die korrigierst du selbst.
2. Behebe zuerst nur den ersten Fehler und prüfe dann erneut. Ein einziger Fehler kann weiter unten mehrere weitere Fehler auslösen.
3. Kontrolliere, dass jede öffnende geschweifte oder eckige Klammer eine schließende hat und die Verschachtelung deiner Absicht entspricht.
4. Prüfe die fertige Datei mit dem Parser, den deine Anwendung verwendet, nicht nur mit einem Webwerkzeug. Parser unterscheiden sich leicht.

Eine Datei, die sich parsen lässt, ist nicht unbedingt die Datei, die du gemeint hast. Prüfe sie mit einem JSON-Schema, um ein fehlendes Feld oder einen Wert mit falschem Typ zu finden, oder vergleiche zwei JSON-Dokumente, um zu sehen, was sich zwischen Versionen geändert hat.

Sonderfälle

• Überflüssige Kommas in generierten Dateien. Manche Werkzeuge schreiben sie. Wenn du JSON von Hand aus Zeichenketten zusammensetzt, nutze den Serialisierer deiner Programmiersprache. Er erzeugt gültige Ausgabe.
• Doppelte Schlüssel. JSON erlaubt sie, die meisten Parser behalten aber nur den letzten Wert. Doppelte Schlüssel sind ein Fehler, der nur darauf wartet, aufzutreten.
• Große Zahlen. Sehr große ganze Zahlen können in manchen Parsern an Genauigkeit verlieren. Speichere Kennungen deshalb als Text, wenn sie länger sind, als der Parser exakt darstellen kann. Der Leitfaden zu CSV und JSON betont dasselbe bei IDs.

Kurze Antworten

Warum schlägt mein JSON fehl, obwohl es richtig aussieht?

Die häufigsten Ursachen sind ein überflüssiges Komma am Ende, einfache Anführungszeichen, ein Kommentar oder typografische Anführungszeichen aus einem Dokument. Prüfe die Position in der Fehlermeldung und das Zeichen direkt davor.

Kann JSON Kommentare haben?

Nein. Der JSON-Standard erlaubt keine Kommentare. Entferne sie oder verschiebe die Notizen in ein eigenes Feld. Die Schaltfläche Repair im Formatierer entfernt sie für dich.

Was verwende ich in JSON statt undefined?

Verwende null, wenn ein Wert absichtlich fehlt, oder lasse den Schlüssel ganz weg. undefined ist ein JavaScript-Wert und hat keine Entsprechung in JSON.