Was ist JSON? Eine Erklärung in Klartext (und wie man häufige Fehler behebt)

JSON ist in moderner Software überall — Konfigurationsdateien, API-Antworten, Datenbanken und Einstellungen bauen darauf. Doch ein einziges verirrtes Komma kann eine ganze Datei zerbrechen und dich vor einem kryptischen „Unexpected token“-Fehler sitzen lassen. Dieser Ratgeber erklärt in Klartext, was JSON ist, wie seine Syntax wirklich funktioniert und wie du die häufigsten Fehler diagnostizierst und behebst.

Was JSON ist

JSON steht für JavaScript Object Notation. Es ist ein leichtgewichtiges, textbasiertes Format zum Speichern und Austauschen strukturierter Daten. Trotz des Namens ist es nicht an JavaScript gebunden — praktisch jede Programmiersprache kann es lesen und schreiben, und genau deshalb wurde es zur Standardsprache von Web-APIs.

Der ganze Sinn von JSON ist, sowohl für Menschen als auch für Maschinen lesbar zu sein. Es stellt Daten als Kombination einiger einfacher Bausteine dar:

• Objekte — Sammlungen von Schlüssel/Wert-Paaren in geschweiften Klammern { }.
• Arrays — geordnete Listen in eckigen Klammern [ ].
• Werte — eine Zeichenkette, eine Zahl, true, false, null, ein Objekt oder ein Array.

Hier ein kleines, aber vollständiges Beispiel:

{
  "name": "Ada Lovelace",
  "active": true,
  "age": 36,
  "skills": ["math", "logic"],
  "address": {
    "city": "London",
    "postcode": null
  }
}

Die Regeln, über die man stolpert

JSON sieht einem JavaScript-Objekt sehr ähnlich, und diese Ähnlichkeit ist die Quelle der meisten Fehler — JSON ist strenger. Behalte diese Regeln im Kopf und du vermeidest die große Mehrheit der Fehler:

1. Schlüssel und Zeichenketten brauchen doppelte Anführungszeichen

Jeder Schlüssel muss eine Zeichenkette in doppelten Anführungszeichen sein, und jeder Textwert muss ebenfalls doppelte Anführungszeichen verwenden. Einfache Anführungszeichen sind kein gültiges JSON, auch wenn sie in JavaScript in Ordnung sind.

// Ungültig
{ 'name': 'Ada' }

// Gültig
{ "name": "Ada" }

2. Keine nachgestellten Kommas

Nach dem letzten Element in einem Objekt oder Array darf kein Komma stehen bleiben. Das ist der mit Abstand häufigste JSON-Fehler, weil viele Editoren und Sprachen es anderswo bereitwillig erlauben.

// Ungültig — Komma nach dem letzten Wert
{ "a": 1, "b": 2, }

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

3. Keine Kommentare

Standard-JSON hat keine Kommentarsyntax. Zeilen, die mit // beginnen, oder Blöcke in /* */ verursachen einen Parse-Fehler. Wenn du Kommentare brauchst, erlauben Formate wie JSON5 oder YAML sie — sieh dir unseren YAML-Formatierer an, falls das besser passt.

4. Zahlen sind schlicht

Zahlen werden ohne Anführungszeichen und ohne führende Nullen oder nachgestellte Dezimalpunkte geschrieben. 01, 1. und .5 sind alle ungültig; schreibe 1, 1.0 und 0.5.

Häufige Fehler und wie man sie behebt

Wenn ein Parser dein JSON ablehnt, meldet er meist Zeile und Spalte. Diese Stelle zeigt, wo der Parser aufgegeben hat — oft direkt hinter dem eigentlichen Fehler. Hier die Meldungen, die du am häufigsten siehst, und was sie wirklich bedeuten:

• "Unexpected token } in JSON" — fast immer ein nachgestelltes Komma vor der schließenden geschweiften oder eckigen Klammer. Entferne das überzählige Komma.
• "Unexpected string" / "Expected comma" — dir fehlt ein Komma zwischen zwei Werten, oder du hast einen Zeilenumbruch benutzt, wo ein Komma stehen sollte.
• "Unexpected token ' in JSON" — einfache Anführungszeichen. Ersetze sie durch doppelte.
• "Unexpected end of JSON input" — eine Klammer wurde nie geschlossen. Zähle deine { und }; jeder Öffner braucht einen passenden Schließer.
• "Unexpected token o in JSON" — ein klassisches Zeichen dafür, dass du etwas zu parsen versucht hast, das bereits ein Objekt war, keine JSON-Zeichenkette. Rufe einen Parser nur auf Text auf.

Der schnellste Weg, die genaue Stelle einzugrenzen, ist, den Text durch einen Formatierer laufen zu lassen, der beim Tippen validiert. Unser JSON-Formatierer und -Validator hebt die genaue Zeile und Spalte des ersten Fehlers hervor und gibt das JSON, sobald es gültig ist, formatiert aus, sodass strukturelle Probleme (eine falsch platzierte Klammer, ein eine Ebene zu tief verschachtelter Wert) auf einen Blick sichtbar werden. Alles läuft in deinem Browser, sodass du private oder sensible Daten sicher prüfen kannst.

Formatieren vs. Minifizieren

Zwei Operationen kommen beim Arbeiten mit JSON ständig vor. Formatieren (auch Verschönern oder Pretty-Printing genannt) fügt Einrückung und Zeilenumbrüche hinzu, um einen dichten Klumpen lesbar zu machen — ideal beim Debuggen. Minifizieren entfernt jedes unnötige Leerzeichen und jeden Zeilenumbruch, um die kleinstmögliche Ausgabe zu erzeugen — ideal für den Versand über das Netz oder das Einbetten in Code, wo Größe zählt. Die Daten sind in beiden Fällen identisch; nur der Leerraum ändert sich.

Kurze Checkliste

Bevor du JSON an ein Programm übergibst, prüfe:

• Alle Schlüssel und Zeichenkettenwerte verwenden doppelte Anführungszeichen.
• Es gibt keine nachgestellten Kommas.
• Es gibt keine Kommentare.
• Jede eckige und geschweifte Klammer ist ausgeglichen.
• Es besteht einen Validator ohne Fehler.

Bekomme diese fünf richtig, und JSON wird, wozu es entworfen wurde: ein langweiliges, vorhersehbares Format, das einfach funktioniert. Wenn doch etwas durchrutscht, füge es in den JSON-Formatierer ein und lass ihn dich direkt zum Problem führen.