JSON Reparatur Tool – Ungültiges JSON online reparieren
JSON Repair Tool
Runs entirely in your browser. Nothing is uploaded.
Was ist
JSON-Reparatur bezeichnet das mechanische Korrigieren fehlerhaften JSONs, sodass es der in RFC 8259 definierten Grammatik entspricht, ohne die zugrunde liegenden Daten zu verändern. Die Spezifikation ist absichtlich streng, und Parser setzen jede einzelne Regel durch. Sechs Regeln verursachen den weitaus größten Teil aller Fehlschläge. Erstens darf ein Komma nicht unmittelbar vor einer schließenden geschweiften oder eckigen Klammer stehen – das ist in vielen Programmiersprachen erlaubt und der häufigste Einzelfehler in handgeschriebenem JSON. Zweitens müssen Objektschlüssel und Zeichenkettenwerte in doppelte Anführungszeichen gesetzt werden; einfache Anführungszeichen und bloße Bezeichner werden abgelehnt. Drittens besitzt das Format überhaupt keine Kommentarsyntax, dennoch schreiben viele Menschen // und /* */-Kommentare in JSON-Dateien, weil sie JSON im JavaScript-Kontext kennengelernt haben.
Viertens muss auf jedes Mitglied eines Objekts und jeden Eintrag eines Arrays ein Komma folgen, außer auf den letzten; ein fehlendes Komma löst eine Kaskade verwirrender Fehlermeldungen aus, die auf die falsche Zeile zeigen. Fünftens dürfen Steuerzeichen wie rohe Zeilenumbrüche, Wagenrückläufe und Tabulatoren nicht wörtlich in einer Zeichenkette stehen; sie müssen als \n, \r und \t maskiert werden. Sechstens muss das Dokument von Anfang bis Ende wohlgeformt sein, ein an einem Pufferlimit abgeschnittenes oder unterbrochen exportiertes Payload wird also niemals parsbar, gleichgültig wie sauber es maskiert ist. Ein Reparaturwerkzeug unterscheidet sich von einem Validator dadurch, was es tut, nachdem es das Problem erkannt hat. Ein Validator meldet einen Fehler und hält an. Ein Reparaturwerkzeug wendet gezielte, umkehrbare Transformationen an: Es entfernt ein Komma, dem nur Leerraum und ein schließendes Token folgen, wandelt einfach quotierte in doppelt quotierte Zeichenketten um, entfernt Kommentar-Token unter Beachtung der Zeichenkettengrenzen und maskiert rohe Steuerzeichen.
Die entscheidende Designbedingung lautet, dass Reparatur konservativ sein muss. Ein Werkzeug, das stillschweigend Daten löscht, damit ein Dokument parsbar wird, ist schlimmer als gar keines, weil es aus einem lauten Fehlschlag stille Korruption macht. Der Ansatz hier ist, ausschließlich das zu ändern, was nachweisbar falsch ist, den Originaltext verfügbar zu halten, damit Sie das Ergebnis vergleichen können, und anschließend einen echten Parse-Lauf zur Bestätigung auszuführen. Ist die Eingabe zu stark beschädigt, um sie automatisch zu reparieren, sagt das Tool das und gibt den Text unverändert zurück, statt so zu tun, als wäre er in Ordnung.
Wie zu verwenden
- Öffnen Sie das JSON Reparatur Tool in Ihrem Browser. Es läuft vollständig clientseitig, sodass nichts, was Sie einfügen, an einen Server übertragen oder irgendwo gespeichert wird.
- Fügen Sie Ihr defektes JSON in das Eingabefeld ein. Das stammt meist aus einer API-Antwort, die Sie nicht parsen konnten, aus einer Konfigurationsdatei, die ein Formatter abgelehnt hat, oder aus Text, der aus einem Log oder Terminalfenster kopiert wurde.
- Klicken Sie auf Reparieren. Das Tool durchsucht den Text und nimmt gezielte Korrekturen für hängende Kommata, einfache Anführungszeichen, nicht quotierte Schlüssel, Kommentare, fehlende Kommata und unmaskierte Steuerzeichen vor.
- Prüfen Sie die Statusanzeige Parse. Ein grünes Ergebnis Gültig bedeutet, dass ein strikter RFC 8259 Parser die reparierte Ausgabe akzeptiert hat und Sie sie direkt in Ihren Code übernehmen können.
- Sehen Sie sich in der Änderungsliste an, welche Korrekturen vorgenommen wurden, damit Sie verstehen, was falsch war, und die eigentliche Quelle des Problems beheben, statt sie zu wiederholen.
- Kopieren Sie das reparierte JSON über die Kopier-Schaltfläche und übernehmen Sie es in Ihren Editor, Ihr Terminal oder Ihre Anwendung. War das Dokument abgeschnitten statt fehlerhaft formatiert, kann die Reparatur die fehlenden Bytes nicht wiederherstellen, exportieren Sie die Originaldaten also erneut.
- Testen Sie das Ergebnis in Ihrer tatsächlichen Anwendung, bevor Sie es ausliefern, denn die Reparatur behebt ausschließlich Syntax und kann keine Werte zurückholen, die schon vorher upstream verloren gegangen sind.
Beispiele
Eingabe: {"name":"Ada","role":"engineer",}
Prozess:
Hängendes Komma vor } entfernenErgebnis: {"name": "Ada", "role": "engineer"} — wird als gültiges JSON geparst
Eingabe: {name: 'Ada', tags: ['math','logic'],}
Prozess:
Nackten Schlüssel quotieren, einfache Anführungszeichen umwandeln, hängendes Komma entfernenErgebnis: {"name": "Ada", "tags": ["math", "logic"]} — wird als gültiges JSON geparst
Eingabe: { // user record "id": 7, "note": "line one line two" }
Prozess:
//-Kommentar entfernen, rohen Zeilenumbruch in der Zeichenkette maskierenErgebnis: {
"id": 7,
"note": "line one\nline two"
} — wird als gültiges JSON geparst
Verwandte Suchen
Leute suchen auch nach: json reparatur tool, ungültiges json reparieren, json online reparieren, json syntaxfehler, json parse error beheben, defektes json.
json reparatur toolungültiges json reparierenjson online reparierenjson syntaxfehlerjson parse error behebendefektes jsonhängendes komma jsoneinfache anführungszeichen jsonjson schlüssel quotierenjson kommentare entfernenfehlendes komma jsonjson steuerzeichen maskierenabgeschnittenes jsonjson validator und reparaturjson offline reparierenclientseitiges json tooljson reparatur ohne uploadjson lokal im browserjson formatierenunexpected token json
Häufig gestellte Fragen
Welche Arten von JSON-Fehler kann dieses Tool tatsächlich beheben?
Das Tool repariert die Syntaxfehler, die den weitaus größten Teil realer Parse-Fehler verursachen: hängende Kommata unmittelbar vor einer schließenden Klammer, einfache Anführungszeichen anstelle doppelter, nicht quotierte Objektschlüssel, im Text verbliebene JavaScript-Zeilen- und Blockkommentare, fehlende Kommata zwischen Objektmitgliedern oder Array-Einträgen, literale Zeilenumbrüche, Tabulatoren und andere Steuerzeichen innerhalb von Zeichenketten sowie Müll hinter dem letzten schließenden Token. Jede Korrektur ist eine gezielte Transformation und keine pauschale Neuschreibung. Abgeschnittene oder beschädigte Dokumente lassen sich nicht reparieren, weil die fehlenden Bytes in dem von Ihnen gelieferten Text nirgends mehr vorhanden sind; das Tool meldet solche Fälle daher als nicht reparierbar, statt Ihre Daten zu raten.
Warum meldet mein JSON einen Fehler in einer Zeile, die völlig in Ordnung aussieht?
JSON-Parser scheitern an der weitest entfernten Stelle, die sie erfolgreich verstanden haben, und das liegt oft weit hinter dem eigentlichen Fehler. Ein früh im Objekt fehlendes Komma lässt den Parser weiterlesen, interpretiert den nächsten Schlüssel als Zeichenkettenwert, und die gemeldete Fehlerposition wandert in eine spätere Zeile, die für sich genommen völlig gültig ist. Deshalb prüfen Einsteiger so oft die falsche Zeile. Der richtige Weg ist, von der gemeldeten Position rückwärts zu suchen und den Trenner zwischen je zwei Mitgliedern zu kontrollieren. Wenn Sie die Eingabe durch dieses Reparatur Tool schicken, isoliert es den echten Defekt schnell, weil es die Fehlerkaskade auflöst und Ihnen genau ein fehlerhaftes Konstrukt übriglässt.
Ist es sicher, Produktionsdaten in ein Online-JSON-Reparatur Tool einzufügen?
Mit diesem Tool ja, weil die Reparatur vollständig in Ihrem Browser über clientseitiges JavaScript erfolgt. Ihr Text wird von Code verarbeitet, der bereits geladen wurde und auf Ihrem eigenen Rechner läuft, sodass der Payload nie über das Netzwerk wandert, nie in ein Server-Log geschrieben wird und nicht vom Betreiber der Seite mitgeschnitten werden kann. Diese Eigenschaft ist wichtiger, als sie klingt: Defekte Payloads sind häufig API-Antworten mit Kundenstammdaten, Authentifizierungs-Headern, Webhook-Geheimnissen oder vollständigen Stack-Traces. Viele gehostete Online-Validatoren protokollieren stillschweigend, was Sie einfügen. Prüfen Sie deshalb bei jedem Werkzeug, ob es eine clientseitige Verarbeitung verspricht, und behandeln Sie dieses Versprechen als Grund, Werkzeuge ohne Konto und ohne Upload zu bevorzugen.
Kann die Reparatur die Bedeutung meiner Daten verändern?
Nein, vorausgesetzt das Werkzeug arbeitet konservativ, und genau diese Bedingung verfolgt diese Implementierung. Die Reparatur verändert ausschließlich Konstrukte, die in gültigem JSON nicht vorkommen dürfen: Ein Komma vor einer schließenden Klammer wird entfernt, eine einfach quotierte Zeichenkette wird mit maskierten doppelten Anführungszeichen neu quotiert, ein Kommentar wird gestrichen, ein fehlender Trenner wird eingesetzt und ein rohes Steuerzeichen wird maskiert. Kein Schlüssel wird umbenannt, kein Wert wird über insignifikante Leerzeichen hinaus umformatiert, und kein Zahlen- oder Zeichenkettenliteral wird neu interpretiert. Da sich jede Transformation von Hand rückgängig machen lässt, können Sie die Änderungsliste lesen und bestätigen, dass das Ergebnis weiterhin die beabsichtigten Daten darstellt. Lässt sich die Eingabe nicht ohne Raten reparieren, lässt das Tool sie unverändert und sagt das auch.
Warum wurde mein JSON ungültig, nachdem ich es in einem Texteditor bearbeitet habe?
Die häufigsten Ursachen sind menschlicher und mechanischer Natur, nicht exotisch. Ein typografisches Anführungszeichen oder ein typografischer Apostroph ist aus einem Textverarbeitungsprogramm statt eines geraden doppelten Anführungszeichens in die Datei gerutscht. Eine automatische Einrückungsfunktion hat hinter dem letzten Eintrag eines Objekts Leerraum plus Komma eingefügt. Ein Suchen-und-Ersetzen hat aus einem Wert eine Zeichenkette mit einem unmaskierten Anführungszeichen oder einem rohen Zeilenumbruch gemacht. Ein YAML- oder JavaScript-Objekt wurde direkt in eine .json-Datei eingefügt und bringt Kommentare und einfache Anführungszeichen mit. Eine unterbrochene Übertragung hat das Dokument mitten in einer Struktur enden lassen. All das erzeugt eine Datei, die für das Auge korrekt aussieht, die ein strikter Parser aber sofort ablehnt – genau die Situation, für die dieses Tool gebaut wurde.
Heißt ein gültiges Ergebnis, dass meine API die Daten auch akzeptiert?
Nein. Gültiges JSON bedeutet nur, dass der Text der JSON-Grammatik entspricht, sodass ein Parser ihn fehlerfrei lesen kann. Ob das Dokument für Ihre Anwendung ebenfalls korrekt ist, ist eine separate Frage, die eine Syntaxreparatur nicht beantworten kann. Feldnamen müssen weiterhin zu Ihrem Schema passen, Zahlen weiterhin in gültigen Bereichen liegen, erforderliche Eigenschaften weiterhin vorhanden sein und verschachtelte Strukturen weiterhin die von Ihrem Server erwartete Form haben. Ein Dokument kann perfekt parsen und trotzdem von einer strengen API-Validierung abgelehnt werden. Betrachten Sie den grünen Status Gültig als Bestätigung, dass der Parse-Fehler beseitigt ist, und schicken Sie die Werte anschließend durch Ihre eigene Schema-Validierung oder Testsuite, bevor Sie sie irgendwohin senden.