Fehler wegen unerwartetem Token in JSON korrigieren

Die Meldung unerwartetes Token stammt vom Parser, also von der Komponente, die Ihren JSON-Text Zeichen für Zeichen einliest. Ein Token ist dabei die kleinste bedeutungstragende Einheit, etwa eine öffnende Klammer, ein Doppelpunkt, ein Komma, eine Zeichenkette oder eine Zahl. Der Parser hat eine klare Erwartung, welches Token an einer bestimmten Position folgen darf. Nach einem Schlüssel erwartet er zum Beispiel einen Doppelpunkt, nach einem Wert ein Komma oder eine schließende Klammer. Trifft er stattdessen auf etwas anderes, bricht er ab und meldet ein unerwartetes Token. Die Meldung sagt also nicht, dass das Zeichen an sich verboten ist, sondern dass es an dieser Stelle nicht erwartet wurde. Genau deshalb ist die Positionsangabe so wertvoll, denn die Ursache liegt oft unmittelbar davor.

Die häufigsten Ursachen für ein unerwartetes Token lassen sich gut eingrenzen. Sehr oft fehlt ein Komma zwischen zwei Einträgen, sodass der Parser nach dem ersten Wert direkt auf den nächsten Schlüssel trifft und diesen als unerwartet meldet. Ebenso häufig steht ein Zeichen zu viel, etwa ein doppelter Doppelpunkt, ein überzähliges Komma oder eine zusätzliche Klammer. Auch einfache statt doppelte Anführungszeichen lösen die Meldung aus, da JSON nur doppelte erlaubt. Ein weiterer Klassiker: Der eingelesene Text ist überhaupt kein JSON, sondern beginnt zum Beispiel mit einer HTML-Fehlerseite. Dann meldet der Parser oft ein unerwartetes Zeichen ganz am Anfang, etwa ein spitzes Klammerzeichen. In all diesen Fällen weist der Validator auf die genaue Position hin, sodass Sie die Art des Problems schnell erkennen.

Ein Sonderfall verdient besondere Aufmerksamkeit, weil er in der Praxis extrem oft vorkommt: die Meldung unerwartetes Token an Position null, häufig verbunden mit einem spitzen Klammerzeichen. Das passiert typischerweise, wenn ein Programm eine Antwort als JSON einlesen will, der Server aber eine HTML-Seite zurückgeschickt hat, etwa eine Fehler- oder Login-Seite. Das erste Zeichen der HTML-Seite ist ein spitzes Klammerzeichen, das der JSON-Parser sofort als unerwartet meldet. Wenn Sie diese Meldung sehen, lohnt sich der Blick auf die tatsächliche Antwort. Kopieren Sie den kompletten Text in den Validator, und Sie erkennen sofort, dass es sich gar nicht um JSON handelt. Die Lösung liegt dann nicht im JSON selbst, sondern darin, warum die Schnittstelle HTML statt JSON liefert, etwa wegen eines Fehlers oder einer falschen Adresse.

Um ein unerwartetes Token zu beheben, gehen Sie systematisch vor. Springen Sie zunächst zur gemeldeten Zeile und Spalte und betrachten Sie das dortige Zeichen. Prüfen Sie dann den Kontext direkt davor, denn oft ist nicht das gemeldete Zeichen falsch, sondern es fehlt etwas davor, meist ein Komma oder ein Anführungszeichen. Fragen Sie sich: Was hätte an dieser Stelle stehen müssen? Nach einem Wert gehört ein Komma oder eine schließende Klammer, nach einem Schlüssel ein Doppelpunkt. Entfernen Sie überzählige Zeichen oder ergänzen Sie fehlende. Weil der Parser beim ersten Fehler stoppt, prüfen Sie nach jeder Korrektur erneut, denn dahinter können weitere unerwartete Tokens liegen. Der Validator führt Sie so Schritt für Schritt durch das Dokument, bis das JSON vollständig gültig ist.

Technisch entspricht die Meldung genau dem, was die Funktion JSON.parse im Browser ausgibt. Diese Funktion liest den Text ein und wirft bei einem unerwarteten Token eine Ausnahme, die den Grund und in modernen Browsern auch die Position enthält. Der Validator führt dieselbe Prüfung aus und bereitet die Meldung verständlich auf, mit Zeile, Spalte und Erklärung. Da die Analyse vollständig lokal in Ihrem Browser läuft, wird Ihr JSON dabei nicht an einen Server gesendet und nicht gespeichert. Das ist besonders wichtig, wenn die problematische Antwort vertrauliche Daten enthält. So finden Sie die Ursache eines Unexpected-token-Fehlers sicher auf Ihrem eigenen Gerät. Die Nutzung ist kostenlos, ohne Registrierung, ohne Wasserzeichen und ohne Limit, direkt in Ihrem Browser.