Ungültiges JSON beheben: die 8 häufigsten Fehler

Die JSON-Regeln in 30 Sekunden

JSON (JavaScript Object Notation) sieht aus wie JavaScript, ist aber viel strenger:

• Schlüssel müssen Strings in doppelten Anführungszeichen sein.
• Strings verwenden ausschließlich doppelte Anführungszeichen.
• Werte können ein String, eine Zahl, true, false, null, ein Objekt oder ein Array sein.
• Elemente werden durch Kommas getrennt, ohne Komma nach dem letzten.
• Keine Kommentare, kein undefined, keine Funktionen.

Den Fehler schnell finden

1. Öffnen Sie den kostenlosen JSON-Formatierer und -Validator.
2. Fügen Sie Ihr JSON ein oder legen Sie eine .json-Datei ab.
3. Ist es ungültig, wird der Fehler mit Zeile und Spalte angezeigt. Springen Sie direkt dorthin.
4. Probieren Sie die Schaltfläche Reparieren, die abschließende Kommas, einfache Anführungszeichen, Schlüssel ohne Anführungszeichen und Kommentare automatisch behebt.
5. Formatieren Sie das Ergebnis mit 2 Leerzeichen, 4 Leerzeichen oder Tabs und erkunden Sie es in der Baumansicht.

1. Abschließende Kommas

// ❌ Ungültig
{ "name": "Ana", "age": 31, }

// ✅ Gültig
{ "name": "Ana", "age": 31 }

JavaScript erlaubt ein Komma nach dem letzten Element, JSON nicht. Das ist mit Abstand der häufigste Fehler, besonders nachdem man die letzte Zeile eines Objekts gelöscht hat.

2. Einfache Anführungszeichen

// ❌ Ungültig
{ 'name': 'Ana' }

// ✅ Gültig
{ "name": "Ana" }

3. Schlüssel ohne Anführungszeichen

// ❌ Ungültig
{ name: "Ana" }

// ✅ Gültig
{ "name": "Ana" }

4. Kommentare

// ❌ Ungültig
{
  // Benutzereinstellungen
  "theme": "dark"
}

Standard-JSON kennt keine Kommentare. Manche Tools akzeptieren „JSONC“ (JSON mit Kommentaren), etwa die Einstellungsdateien von VS Code, die meisten Parser aber nicht. Entfernen Sie Kommentare oder schreiben Sie Notizen in ein Feld wie "_comment".

5. Fehlende Kommas zwischen Elementen

// ❌ Ungültig
{ "a": 1 "b": 2 }

// ✅ Gültig
{ "a": 1, "b": 2 }

Meist passiert das, wenn man eine neue Zeile hinzufügt und das Komma in der Zeile davor vergisst. Der Fehler wird am Anfang des nächsten Elements gemeldet.

6. Fehlende oder falsch gepaarte Klammern

// ❌ Ungültig: Das Array wird nie geschlossen
{ "tags": ["a", "b" }

Fehler wie „Unexpected end of JSON input“ bedeuten oft, dass eine schließende } oder ] fehlt oder der Text abgeschnitten wurde. Mit Einrückung formatiertes JSON lässt sich leicht auf seine Struktur prüfen.

7. Ungültige Werte

// ❌ Ungültig
{ "price": NaN, "date": undefined, "big": 1e999, "hex": 0xFF, "zip": 01234 }

// ✅ Gültig
{ "price": null, "date": null, "hex": 255, "zip": "01234" }

JSON-Zahlen dürfen keine führenden Nullen, keine Hexadezimalschreibweise und weder NaN noch Infinity enthalten. Speichern Sie Postleitzahlen und Telefonnummern als Strings, damit führende Nullen erhalten bleiben.

8. Nicht maskierte Zeichen in Strings

// ❌ Ungültig
{ "path": "C:\Users\ana", "quote": "Sie sagte "hallo"" }

// ✅ Gültig
{ "path": "C:\\Users\\ana", "quote": "Sie sagte \"hallo\"" }

Backslashes und doppelte Anführungszeichen in Strings müssen mit einem Backslash maskiert werden. Echte Zeilenumbrüche in einem String werden als \n geschrieben.

Fehler, die eigentlich keine JSON-Probleme sind

• „Unexpected token < in JSON at position 0“: Sie haben HTML statt JSON erhalten. Die API hat vermutlich eine Fehlerseite oder eine Weiterleitung zum Login geliefert. Prüfen Sie Statuscode und URL.
• „Unexpected end of JSON input“ bei leerer Antwort: Der Server hat nichts gesendet. Prüfen Sie die Anfrage, nicht den Parser.
• Unsichtbare Zeichen: eine Byte-Order-Mark (BOM) oder typografische Anführungszeichen aus einem Textverarbeitungsprogramm. Tippen Sie die Anführungszeichen neu oder speichern Sie die Datei als UTF-8 ohne BOM.

JSON-Fehler von vornherein vermeiden

• JSON nie von Hand im Code zusammenbauen. Nutzen Sie JSON.stringify() in JavaScript oder json.dumps() in Python.
• Einen Editor mit JSON-Validierung nutzen, etwa VS Code, der Fehler beim Tippen unterstreicht.
• API-Daten validieren, in Ihren Tests gegen ein JSON Schema.
• Schlüssel sortieren, bevor Sie zwei JSON-Dateien vergleichen, damit Diffs nur echte Änderungen zeigen.

Häufige Fragen

Warum funktioniert mein JSON in JavaScript, aber nicht mit JSON.parse?

JavaScript-Objektliterale erlauben einfache Anführungszeichen, Schlüssel ohne Anführungszeichen, abschließende Kommas und Kommentare. JSON nicht, daher scheitert Code, der in einer .js-Datei gut aussieht, als JSON.

Darf JSON Kommentare enthalten?

Nicht im Standard. Formate wie JSONC und JSON5 erlauben sie, aber nur mit Parsern, die diese Formate unterstützen.

Ist es sicher, API-Antworten in einen Online-Formatierer einzufügen?

Nur wenn er Ihre Daten nicht hochlädt. Unser Formatierer verarbeitet alles in Ihrem Browser, Tokens und persönliche Daten bleiben also auf Ihrem Gerät.

Fazit

JSON-Fehler gehen fast immer auf eine kurze Liste von Fehlern zurück. Validieren Sie, um die genaue Stelle zu finden, beheben Sie den ersten Fehler, validieren Sie erneut, und erzeugen Sie JSON wann immer möglich per Code statt von Hand.