JSON-Reparatur: Kaputtes JSON von APIs und LLMs reparieren

Häufige JSON-Fehler

JSON folgt strengen Syntaxregeln, an denen Entwickler regelmäßig scheitern. Ein einziges falsch platziertes Komma, ein Schlüssel ohne Anführungszeichen oder ein nachgestelltes Komma nach dem letzten Element macht das gesamte Dokument ungültig. Standard-JSON-Parser lehnen solche Fehler komplett ab und liefern nichts als eine Fehlermeldung und eine Zeilennummer – keine Teildaten, keine Vorschläge.

Zu den häufigsten JSON-Fehlern zählen nachgestellte Kommas nach der letzten Eigenschaft oder dem letzten Array-Element, einfache statt doppelte Anführungszeichen um Strings, Eigenschaftsschlüssel ohne Anführungszeichen, in die Daten eingebettete Kommentare (// oder /* */), fehlende schließende Klammern und nicht maskierte Sonderzeichen innerhalb von String-Werten. JSON-Reparatur-Tools beheben all das automatisch.

So funktioniert JSON-Reparatur

Ein JSON-Reparatur-Tool setzt auf einen parserbasierten Ansatz statt auf einfaches Suchen und Ersetzen per Regex. Es liest die Eingabe Zeichen für Zeichen und pflegt einen Zustandsautomaten, der die aktuelle Position in der JSON-Struktur verfolgt (Objekt, Array, String, Wert). Trifft es auf ungültige Syntax, leitet es die beabsichtigte Struktur aus dem Kontext ab und korrigiert sie.

• Parserbasierte Korrektur – die Reparatur-Engine pflegt einen Parse-Zustand (innerhalb eines Objekts, innerhalb eines Arrays, innerhalb eines Strings, Wert erwartet) und nutzt diesen Kontext, um die richtige Korrektur zu bestimmen, statt blind Regex-Muster anzuwenden
• Ausgleich von Klammern – verfolgt öffnende und schließende Klammern und ergänzt fehlende Schließungen automatisch am Ende des Dokuments oder fügt sie dort ein, wo die Struktur sie erwarten lässt
• Normalisierung von Anführungszeichen – wandelt einfache in doppelte Anführungszeichen um, ergänzt fehlende Anführungszeichen um Schlüssel und maskiert Sonderzeichen korrekt, die String-Werte sonst zerstören würden

LLM-Ausgaben und abgeschnittenes JSON

Große Sprachmodelle erzeugen häufig fehlerhaftes JSON. Sie schneiden die Ausgabe mitten im Objekt ab, wenn sie an Token-Grenzen stoßen, vergessen schließende Klammern in tief verschachtelten Strukturen, hängen nachgestellte Kommas nach der letzten Eigenschaft an oder fügen erklärende Kommentare innerhalb von JSON-Blöcken ein. Die JSON-Reparatur behandelt all diese LLM-spezifischen Probleme.

• Abgeschnittene Ausgabe – wenn ein LLM aufgrund von Token-Grenzen mitten im Objekt aufhört zu generieren, schließt das Reparatur-Tool alle offenen Strukturen (Strings, Arrays, Objekte) in der richtigen Reihenfolge, um aus der Teilausgabe gültiges JSON zu erzeugen
• Markdown-Code-Fences – LLMs verpacken JSON oft in ```json...```-Blöcke. Das Reparatur-Tool entfernt diese Fences vor der Verarbeitung und verarbeitet sowohl umschlossenes als auch nicht umschlossenes JSON transparent
• Gemischter Inhalt – LLMs geben mitunter Text vor oder nach dem JSON-Block aus oder fügen Inline-Kommentare ein. Das Reparatur-Tool extrahiert nur den JSON-Teil und behebt darin enthaltene Syntaxfehler

Häufig gestellte Fragen

Kann die JSON-Reparatur destruktive Änderungen verursachen?

Die JSON-Reparatur ist bewusst konservativ – sie behebt ausschließlich Syntaxfehler und verändert niemals Datenwerte. Ein nachgestelltes Komma wird entfernt, eine fehlende Klammer ergänzt, einfache Anführungszeichen werden zu doppelten, aber die eigentlichen Daten (Strings, Zahlen, Boolesche Werte, Arrays, Objekte) bleiben unberührt. Die reparierte Ausgabe ist semantisch identisch mit dem, was der Autor beabsichtigt hat.

Wie geht die Reparatur mit Kodierungsproblemen um?

JSON erfordert UTF-8-Kodierung. Das Reparatur-Tool behandelt gängige Kodierungsprobleme wie ein BOM (Byte Order Mark) am Dateianfang, ungültige Escape-Sequenzen (\x statt \u für Hex) und nicht maskierte Steuerzeichen innerhalb von Strings. Es normalisiert diese zu gültigem, JSON-konformem UTF-8.

Kann tief verschachteltes JSON repariert werden?

Ja. Der parserbasierte Ansatz bewältigt beliebig tiefe Verschachtelung, weil er einen Stack offener Strukturen pflegt. Ob die Eingabe 3 oder 30 Verschachtelungsebenen hat – die Reparatur-Engine verfolgt jede Ebene und schließt korrekt alle offen gebliebenen Strukturen. Genau hier scheitern regexbasierte Ansätze vollständig.