JSON Syntaxfehler: Ursachen anhand der Fehlermeldung finden

Inhalt
Die Fehlermeldung „Unexpected token“, die beim Einfügen von JSON erscheint, bedeutet, dass eine der JSON-Syntaxregeln verletzt wurde. In der Meldung steht bereits, bei welchem Zeichen und an welcher Stelle das Problem auftritt. Dieser Beitrag fasst die häufigsten Syntaxfehler zusammen und zeigt, wie Sie anhand der Meldung die Ursache finden.
Zusammenfassung ① JSON erlaubt weder Trailing Commas (Kommas nach dem letzten Element) noch einfache Anführungszeichen, Kommentare oder Schlüssel ohne Anführungszeichen. ② Die Fehlermeldung von JSON.parse zeigt das problematische Zeichen und die Position (position) an. ③ Der Positionswert ist die Anzahl der Zeichen ab Beginn der Zeichenkette. Wenn Sie sich die Stelle davor und danach ansehen, lässt sich die Ursache eingrenzen.
Warum diese Fehler so häufig auftreten
Es kommt oft vor, dass man eine API-Antwort aus der Konsole kopiert und in eine Konfigurationsdatei einfügt, oder dass man mehrere Antworten von Hand zusammensetzt und dabei hinter dem letzten Eintrag ein Komma stehen lässt. Ebenfalls häufig: Ein Objektliteral aus JavaScript-Code wird unverändert herausgelöst und als JSON eingefügt.
Beide Syntaxformen sehen auf den ersten Blick ähnlich aus, folgen aber unterschiedlichen Regeln. Ausdrücke, die in einem JavaScript-Objektliteral funktionieren (einfache Anführungszeichen, Schlüssel ohne Anführungszeichen, Trailing Commas), sind in JSON allesamt Syntaxfehler. Übernimmt man also einen Wert, der im Code einwandfrei lief, unverändert, wirft JSON.parse sofort einen Fehler.
Das Problem: Die Fehlermeldung wirkt wie Code, etwa „Unexpected token } in JSON at position 42“. Wer nicht weiß, gegen welche Syntaxregel verstoßen wurde und worauf sich die Zahl 42 bezieht, findet die Ursache auch nach dem Lesen der Meldung nicht.
JSON-Syntaxregeln und wie Sie Fehlermeldungen lesen
JSON ist ein Standardformat mit festgelegter Syntax. Die Regeln, die in der Praxis Fehler auslösen, lassen sich auf einige wenige zusammenfassen.
- Zeichenketten und Schlüssel stehen immer in doppelten Anführungszeichen ("). Einfache Anführungszeichen (') gibt es in der JSON-Syntax nicht.
- Nach dem letzten Eintrag eines Objekts oder Arrays steht kein Komma (Trailing Commas sind nicht erlaubt).
- Schlüssel müssen stets Zeichenketten in Anführungszeichen sein. Schlüssel ohne Anführungszeichen sind keine JSON-Syntax, sondern die Syntax von JavaScript-Objektliteralen.
- Kommentare (// oder /* */) sind in der JSON-Syntax selbst nicht vorgesehen.
- Zahlen dürfen keine überflüssige führende 0 (wie bei 01) und kein Pluszeichen (+) haben, und Werte wie NaN oder Infinity sind nicht zulässig.
- true, false und null werden ausschließlich kleingeschrieben.
Verstößt etwas gegen eine dieser Regeln, gibt JSON.parse im Browser keinen Wert zurück, sondern wirft einen Fehler (SyntaxError).
Positionsangabe (position) in der Fehlermeldung lesen
Der Fehler enthält zwei Informationen: das problematische Zeichen und die Position (position), also an der wievielten Stelle der Zeichenkette dieses Zeichen steht. Die Position ist die Anzahl der Zeichen ab dem Anfang der Zeichenkette (0), Zeilenumbrüche eingeschlossen.
Das Format der Meldung unterscheidet sich je nach Browser-Engine. Chromium-basierte Browser zeigen position (Zeichenposition) an, Firefox-basierte Browser line und column (Zeile und Spalte). Gemeint ist aber dieselbe Stelle.
Um die Ursache zu finden, sehen Sie sich anhand dieser Position die Zeichen davor und danach an. Je länger das JSON ist, desto mühsamer und fehleranfälliger wird es allerdings, die Position von Hand abzuzählen.
Prüfen Sie es mit unserem JSON-Formatierer und -Validator.
Fügen Sie Ihr JSON ein und klicken Sie auf die Formatieren-Schaltfläche, um Fehlerposition und Meldung sofort zu sehen. Die Verarbeitung erfolgt nur im Browser, es werden keine Daten an einen Server gesendet.

Häufig verwechselte Syntaxfehler
Auch wenn das Ergebnis immer „Es gibt einen Fehler“ lautet, sind die Ursachen verschieden. Die häufigsten Typen im Überblick:
| Fehlertyp | Beispiel | Warum es ein Fehler ist |
|---|---|---|
| Trailing Comma | {"a":1,"b":2,} | Nach dem letzten Eintrag steht kein Komma |
| Einfache Anführungszeichen | {'a':1} | Zeichenketten und Schlüssel sind nur in doppelten Anführungszeichen erlaubt |
| Anführungszeichen beim Schlüssel fehlen | {a:1} | Schlüssel müssen Zeichenketten in Anführungszeichen sein |
| Kommentar enthalten | {"a":1} // Erklärung | Die JSON-Syntax kennt keine Kommentare |
| undefined als Wert | {"a":undefined} | JSON kann undefined nicht darstellen (nur null ist möglich) |
| Führende 0 bei Zahlen | {"a":01} | Zahlen, die mit 0 beginnen, sind nur für die 0 selbst erlaubt |
Trailing Commas und einfache Anführungszeichen sind in JavaScript-Code ganz normale Schreibweisen. Deshalb schleichen sie sich besonders oft ein, wenn man Werte aus dem Code kopiert und als JSON verwendet.
Zusammenfassung
- JSON folgt einer festen Syntax mit Regeln zu doppelten Anführungszeichen, Kommas usw. und unterscheidet sich damit von JavaScript-Objektliteralen.
- Trailing Commas, einfache Anführungszeichen, Schlüssel ohne Anführungszeichen und Kommentare sind in der Praxis die häufigsten Fehlerursachen.
- Die Fehlermeldung von JSON.parse enthält das problematische Zeichen und die Position (position bzw. line/column).
- Der Positionswert ist die Anzahl der Zeichen ab Beginn der Zeichenkette. Wenn Sie die Stelle davor und danach prüfen, lässt sich die Ursache eingrenzen.
- Bei langem JSON ist es schneller und genauer, die Position mit einem Tool zu prüfen, statt sie von Hand abzuzählen.
Fügen Sie Ihr JSON ein und klicken Sie auf die Formatieren-Schaltfläche, um Fehlerposition und Meldung sofort zu sehen. Die Verarbeitung erfolgt nur im Browser, es werden keine Daten an einen Server gesendet.
Häufig gestellte Fragen
Was bedeutet der Fehler „Unexpected token“ genau?
JSON.parse ist auf ein Zeichen gestoßen, das an dieser Stelle laut Syntax nicht vorkommen darf. In der Meldung stehen dieses Zeichen und die Stelle der Zeichenkette (position), an der es gefunden wurde. Wenn Sie die Stelle davor und danach prüfen, finden Sie die Ursache meist sofort.
Was bedeutet die Zahl hinter „position“?
Es ist die Anzahl der Zeichen (Zeichenindex), wobei der Anfang der Zeichenkette als 0 gilt. Zeilenumbruchzeichen werden mitgezählt. Bei position 42 liegt das Problem zum Beispiel beim 43. Zeichen ab dem Beginn der Zeichenkette.
Warum verursacht JSON mit Kommentaren einen Fehler?
Weil die JSON-Syntax selbst keine Schreibweise für Kommentare definiert. Kommentare wie // oder /* */ sind in JavaScript sowie in Erweiterungen wie JSON5 oder JSONC erlaubt, in Standard-JSON werden sie aber als Fehler behandelt.
Darf ich ein JavaScript-Objekt unverändert als JSON verwenden?
Nein. In einem JavaScript-Objektliteral dürfen Schlüssel ohne Anführungszeichen stehen, einfache Anführungszeichen verwendet werden und Trailing Commas stehen bleiben. JSON wertet all das als Syntaxfehler. Erst wenn Sie alles in doppelte Anführungszeichen setzen und das letzte Komma entfernen, ist es gültiges JSON.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen