„Unexpected token <“: HTML statt JSON in Formular und Web-App
Kurz gesagt: Die Meldung „Unexpected token '<', "<!DOCTYPE "... is not valid JSON“ in der Browser-Konsole bedeutet fast immer dasselbe: Ihr Formular, Ihre Buchungsstrecke oder Ihre Web-App hat Daten von einer Schnittstelle erwartet und stattdessen eine HTML-Seite bekommen. Das spitze Klammerzeichen ist der Anfang dieser HTML-Seite. Typische Ursachen sind eine falsche Adresse mit 404-Fehlerseite, eine abgelaufene Anmeldung mit Weiterleitung auf die Login-Seite, eine Sperrseite einer Firewall oder eine Fehlerseite des Servers. Die Lösung beginnt im Netzwerk-Reiter des Browsers: Dort sehen Sie, was tatsächlich zurückkam. Danach korrigieren Sie die Ursache und bauen die Fehlerbehandlung so, dass Kunden eine verständliche Meldung sehen.
Was die Meldung bedeutet
Viele Funktionen einer modernen Website holen Daten im Hintergrund: Das Kontaktformular sendet Angaben und erwartet eine Bestätigung, der Terminkalender lädt freie Zeiten, der Warenkorb aktualisiert Preise. Die Antwort kommt meist im JSON-Format, einem einfachen Datenformat.
Das Skript auf der Seite versucht, die Antwort als JSON zu lesen. Laut MDN wirft JSON.parse einen Fehler vom Typ SyntaxError, wenn der Text nicht als JSON gelesen werden kann. Auch die Methode json() einer Fetch-Antwort meldet laut MDN einen SyntaxError, wenn der Inhalt kein gültiges JSON ist. Beginnt die Antwort mit „<!DOCTYPE html>“ oder „<html>“, scheitert das sofort am ersten Zeichen.
Die genaue Formulierung der Meldung unterscheidet sich je nach Browser. Gemeinsam ist allen der Hinweis auf ein unerwartetes Zeichen am Anfang.
Die häufigsten Ursachen
1. Die Adresse der Schnittstelle stimmt nicht. Nach einem Umzug in einen Unterordner, einer Änderung der Permalinks oder einem Wechsel der Domain zeigt das Skript auf eine Adresse, die es nicht mehr gibt. Der Server antwortet mit seiner gestalteten 404-Seite, also mit HTML.
2. Die Anmeldung ist abgelaufen. Bei Kundenbereichen oder internen Werkzeugen leitet der Server nicht angemeldete Anfragen auf die Login-Seite um. Das Skript bekommt dann das HTML der Login-Seite.
3. Eine Sperrseite. Eine Web-Application-Firewall, ein CDN oder ein Sicherheits-Plugin blockiert die Anfrage und liefert eine eigene HTML-Seite aus.
4. Eine Fehlerseite des Servers. Bei einem internen Fehler liefert der Server eine HTML-Fehlerseite statt einer Antwort im erwarteten Format.
5. Warnungen vor den Daten. Gibt die Anwendung auf dem Server vor dem eigentlichen JSON Warnungen oder Hinweise als Text aus, ist die Antwort ebenfalls kein gültiges JSON mehr.
6. Eine Wartungsseite. Während Updates zeigt der Server einen Wartungshinweis, auch für Anfragen an Schnittstellen.
Schritt 1: Die Antwort ansehen
Öffnen Sie die Entwicklerwerkzeuge des Browsers und wechseln Sie in den Reiter Netzwerk. Lösen Sie die Aktion erneut aus, etwa das Absenden des Formulars. Suchen Sie die betroffene Anfrage und prüfen Sie:
- Statuscode: 404 deutet auf eine falsche Adresse, 401 oder 403 auf fehlende Anmeldung oder eine Sperre, 500 auf einen Serverfehler, 503 auf Wartung oder Überlastung.
- Weiterleitung: Wurde die Anfrage auf eine andere Adresse umgeleitet, etwa auf die Login-Seite?
- Antwortinhalt: In der Vorschau sehen Sie, welche Seite tatsächlich zurückkam. Der Titel der HTML-Seite verrät oft schon die Ursache.
Mit diesen drei Angaben ist die Ursache meist eindeutig.
Schritt 2: Die Ursache beheben
Je nach Befund:
- Falsche Adresse: Korrigieren Sie die Adresse im Skript oder in den Einstellungen des Plugins. Nach einem Umzug prüfen Sie Basis-Adressen und Permalinks.
- Abgelaufene Anmeldung: Sorgen Sie dafür, dass die Anwendung bei fehlender Anmeldung eine verständliche Meldung zeigt und zur Anmeldung führt, statt still zu scheitern.
- Sperrseite: Prüfen Sie im Protokoll der Firewall, welche Regel gegriffen hat, und passen Sie sie an.
- Serverfehler oder Warnungen: Lassen Sie das Fehlerprotokoll des Servers prüfen. Warnungen gehören ins Protokoll, nicht in die Antwort.
Schritt 3: Die Fehlerbehandlung verbessern
Auch wenn die Ursache behoben ist, sollte die Seite robuster werden. Bitten Sie die Person, die den Code pflegt, um drei Anpassungen:
- Status prüfen, bevor gelesen wird: Laut MDN zeigt die Eigenschaft ok einer Fetch-Antwort, ob der Status im Bereich 200 bis 299 liegt. Ist das nicht der Fall, sollte das Skript gar nicht erst versuchen, JSON zu lesen.
- Inhaltstyp prüfen: Stimmt der Content-Type der Antwort nicht mit JSON überein, liegt ein Problem vor, das gesondert behandelt werden sollte.
- Verständliche Meldung anzeigen: Statt einer leeren Seite oder einer Fehlermeldung in Entwicklersprache sieht die Kundin einen Satz wie „Ihre Anfrage konnte gerade nicht gesendet werden. Bitte versuchen Sie es später erneut oder rufen Sie uns an.“
Zusätzlich lohnt es sich, solche Fehler zu protokollieren, damit sie auffallen, bevor Kunden anrufen.
Typische Fehler bei der Fehlersuche
- Nur die Konsole lesen: Die Meldung in der Konsole nennt das Symptom, nicht die Ursache. Erst der Netzwerk-Reiter zeigt, welche Seite tatsächlich zurückkam.
- Angemeldet testen: Wer als Administratorin testet, sieht Fehler durch abgelaufene Anmeldungen oder Sperren für Gäste nicht. Prüfen Sie zusätzlich in einem privaten Fenster.
- Cache übersehen: Ein CDN oder ein Caching-Plugin kann alte Skripte mit veralteten Adressen ausliefern. Leeren Sie die Caches nach Änderungen.
- Fehler unterdrücken statt beheben: Ein Skript, das alle Fehler stillschweigend abfängt, versteckt das Problem. Kunden warten dann vor einem endlosen Ladekreis.
- Nur ein Gerät prüfen: Firewalls und Sperren reagieren je nach Netz unterschiedlich. Testen Sie auch über das Mobilfunknetz.
Ein Beispiel zur Veranschaulichung
Frei erfunden: Eine Physiotherapiepraxis aus Freiburg nutzt ein Buchungsformular, das freie Termine im Hintergrund lädt. Nach einem Wechsel auf eine neue Domain zeigt der Kalender nur noch einen Ladekreis. In der Konsole steht die Meldung mit dem unerwarteten Zeichen, im Netzwerk-Reiter liefert die Anfrage einen 404 mit der Fehlerseite der neuen Website. Das Plugin war noch auf die alte Adresse eingestellt. Nach der Korrektur lädt der Kalender wieder. Die Agentur ergänzt außerdem einen Hinweis mit Telefonnummer, falls das Laden künftig scheitert.
Häufige Fragen
Ist das ein Fehler im Browser der Kunden?
Nein. Der Browser meldet korrekt, dass die Antwort kein JSON ist. Die Ursache liegt auf der Seite des Servers oder in der Konfiguration.
Warum tritt der Fehler nur manchmal auf?
Wenn die Ursache eine abgelaufene Anmeldung, eine zeitweise Sperre oder ein Wartungsfenster ist, kommt die HTML-Seite nur in diesen Situationen.
Kann ich das ohne Programmierkenntnisse prüfen?
Den Netzwerk-Reiter zu öffnen und Statuscode sowie Antwort anzusehen, gelingt auch ohne Programmierkenntnisse. Die Korrektur im Code übernimmt dann Ihre Agentur.
Wenn Formulare oder Buchungen auf Ihrer Website mit dieser Meldung scheitern, finden wir die Ursache gerne gemeinsam: Formularfehler melden.