JSON online validieren (und was jede Fehlermeldung bedeutet)
JSON online validieren und den Fehler verstehen: Schlusskomma, einfache Anführungszeichen, Schlüssel ohne Anführungszeichen, Kommentare, BOM, doppelte Schlüssel.
Aktualisiert am 8. November 20269 Min. Lesezeit
Um JSON zu validieren, fügen Sie es in den JSON-Validator ein oder ziehen die .json-Datei darauf und klicken auf Validieren. Gültiges JSON erhält ein grünes Ergebnis mit Wurzeltyp und Struktur. Ungültiges JSON erhält ein rotes Ergebnis und eine Liste aller Fehler auf einmal, jeweils mit Zeile, Spalte und einem Caret unter dem genauen Zeichen. Schwierig ist meist nicht die Feststellung, dass etwas falsch ist, sondern die Meldung zu verstehen, denn jedes Programm formuliert sie anders. Dieser Leitfaden erklärt, was die üblichen Meldungen bedeuten, welche „Fehler“ in Wahrheit ein anderer JSON-Dialekt sind, warum eine einwandfreie Datei an Position 0 scheitert und welche zwei Probleme jeden Parser lautlos passieren.
JSON online validieren, Schritt für Schritt
JSON einfügen oder Datei hinzufügen
Öffnen Sie den JSON-Validator und fügen Sie den Text in den Editor ein oder legen Sie eine Datei ab. Akzeptiert werden .json, .jsonc, .json5, .ndjson, .jsonl, .geojson, .webmanifest, .har, .map und .txt. Minifiziertes und eingerücktes JSON funktionieren beide.
Dokumenttyp auf Automatisch lassen
Automatisch liest den Text als ein einziges JSON-Dokument. Sieht er nach einem Datensatz pro Zeile aus, bietet das Werkzeug an, ihn als NDJSON zu prüfen, statt das eigenmächtig umzustellen.
Auf Validieren klicken
Bei Erfolg sehen Sie den Wurzeltyp (Objekt, Array usw.), die Zahl der Schlüssel oder Einträge und einen Strukturbericht: Knoten, maximale Tiefe, Objekte, Arrays, Schlüssel, Zeilen, Größe und die gelesene Kodierung. Bei einem Fehlschlag wird jeder Fehler mit Ln und Spalte aufgeführt; mit Springen setzen Sie den Cursor direkt an die Stelle.
Auch die Warnungen lesen
Doppelte Schlüssel und Zahlen, die an Genauigkeit verlieren, erscheinen als Warnungen. Sie ändern das Ergebnis nicht, weil jeder Parser sie akzeptiert, aber genau dort verschwinden Daten unbemerkt.
Von Hand korrigieren oder die reparierte Kopie nehmen
Sind die einzigen Probleme Kommentare, Schlusskommas, einfache Anführungszeichen und Ähnliches, wird eine reparierte Kopie in striktem JSON angeboten. Mit Repariertes JSON übernehmen landet sie im Editor, oder Sie wählen Repariertes .json herunterladen.
Was JSON-Fehlermeldungen wirklich bedeuten
Jede Programmiersprache und jede App formuliert dieselben wenigen Fehler auf ihre Weise, und die gemeldete Position ist die Stelle, an der der Parser aufgegeben hat, oft ein Zeichen nach Ihrem eigentlichen Fehler. Die Tabelle übersetzt die typischen englischen Meldungen, die Ihnen anderswo begegnen, in die Ursache und in die Meldung, die der Validator dafür anzeigt.
| Typische Meldung anderswo | Was sie meist bedeutet | Was der Validator sagt |
|---|---|---|
| „Expected double-quoted property name“ oder „Expecting property name enclosed in double quotes“ | Ein Schlusskomma vor }, ein Schlüssel in einfachen Anführungszeichen oder ganz ohne | Ein Schlusskomma vor der schließenden Klammer; oder: Der Schlüssel steht nicht in Anführungszeichen |
| „Unexpected token“ oder „Expecting value“ | Etwas, das kein JSON-Wert ist: ein Kommentar, NaN, undefined, True oder ein verirrtes Zeichen | JSON erlaubt keine Kommentare; oder: Das ist kein JSON-Wert |
| „Expecting ',' delimiter“ | Zwei Einträge ohne Komma dazwischen | Vor diesem Wert fehlt ein Komma |
| „Unexpected end of JSON input“ | Eine Klammer wurde nie geschlossen, oder der Text ist abgeschnitten | Ein Objekt (oder Array) wird geöffnet und nie geschlossen |
| „Unterminated string“ oder „Bad control character in string literal“ | Ein fehlendes schließendes Anführungszeichen oder ein echter Zeilenumbruch bzw. Tabulator in einer Zeichenkette | Diese Zeichenkette wird nie geschlossen; oder: Ein Steuerzeichen muss maskiert werden |
| „Unexpected non-whitespace character after JSON“ oder „Extra data“ | Zwei zusammenkopierte Dokumente oder ein Datensatz pro Zeile | Der JSON-Wert endet davor; alles ab hier ist überzählig |
| „Unexpected token“ an Position 0 oder „Unexpected UTF-8 BOM“ | Unsichtbare Bytes vor der ersten Klammer, oder die Datei ist gar kein JSON | Die Markierung wird entfernt und die Kodierung gemeldet |
Eine „Position“ in solchen Meldungen zählt Zeichen ab null: Position 0 ist das allererste Zeichen, Position 7 das achte. Zeilen und Spalten zählen ab eins. Der Validator nennt Ihnen all das, dazu einen Byte-Offset für Skripte, und berechnet die Werte selbst, sodass die Stelle in jedem Browser dieselbe ist.
Alle Fehler auf einmal mit Zeile, Spalte und Caret, dazu doppelte Schlüssel, Genauigkeitswarnungen, JSON Schema und Reparatur. Kostenlos: eingefügter Text oder eine Datei bis 25 MB, alle Prüfungen inbegriffen. Pro: bis zu 100 Dateien in einem Durchgang und maschinenlesbare Berichte als JSON und CSV. Alles läuft auf Ihrem Gerät, nicht auf unseren Servern.
JSON validierenSchlusskommas, einfache Anführungszeichen, Schlüssel ohne Anführungszeichen, Kommentare: kaputt oder ein Dialekt?
Viele Dateien, die als ungültiges JSON gemeldet werden, sind gar nicht beschädigt. Sie sind in einem lockereren Dialekt geschrieben, den Ihr Editor problemlos liest und ein strikter Parser ablehnt. Wenn Sie wissen, welcher es ist, wissen Sie auch, ob die Datei oder das lesende Programm angepasst werden muss.
- JSONC (JSON mit Kommentaren) erlaubt Kommentare mit // und /* */ sowie Schlusskommas. tsconfig.json, .eslintrc und die meisten Editor-Einstellungsdateien sind JSONC. Im Editor funktionieren sie, in einer Pipeline, die reines JSON erwartet, scheitern sie.
- JSON5 erlaubt zusätzlich Schlüssel ohne Anführungszeichen, Zeichenketten in einfachen Anführungszeichen, Hexadezimalzahlen, ein führendes Plus oder einen führenden Dezimalpunkt sowie NaN und Infinity.
- Ein Python-Dictionary, das ein Skript ausgegeben hat, sieht aus wie JSON, verwendet aber True, False und None und oft einfache Anführungszeichen.
- Text aus einer Textverarbeitung enthält mitunter typografische Anführungszeichen („ “ oder “ ”) statt gerader. Sie sehen richtig aus und sind kein JSON.
Handelt es sich um einen dieser Fälle, sagt der Validator das klar (etwa, dass es JSONC ist und kein kaputtes JSON) und listet die verantwortlichen Konstrukte auf. Die Reparatur arbeitet mit dem, was der Scanner gefunden hat, sodass ein // in einer URL oder ein Komma in einem Wert in Anführungszeichen nie angetastet wird. NaN und Infinity haben keine Schreibweise in JSON und werden zu null; diese Änderung wird ausdrücklich genannt. Bleiben neben dem Dialekt echte Syntaxfehler, wird keine reparierte Kopie angeboten. Wie Sie das Ergebnis anschließend lesbar einrücken, steht in der Anleitung JSON online formatieren.
Warum eine einwandfreie Datei an Position 0 scheitert: BOM und UTF-16
Zeigt ein Fehler auf Position 0, Zeile 1, Spalte 1, und die Datei sieht in Ordnung aus, liegt es meist an Bytes, die Sie nicht sehen. Eine UTF-8-Bytereihenfolgemarkierung (BOM) besteht aus drei Bytes, EF BB BF, die manche Windows-Werkzeuge vor den Text schreiben, darunter Out-File in PowerShell, StreamWriter in .NET und der UTF-8-Export von Excel. Ein strikter Parser sieht vor der öffnenden Klammer ein unerwartetes Zeichen und lehnt ein ansonsten korrektes Dokument ab.
UTF-16 ist noch tückischer: Windows PowerShell schreibt es, wenn keine Kodierung angegeben ist, und als UTF-8 gelesen sieht es aus wie ein NUL-Byte nach jedem Zeichen. Der Validator erkennt beides, prüft das Dokument, als gäbe es die Markierung nicht, und nennt die verwendete Kodierung im Strukturbericht. Damit andere Programme die Datei lesen können, speichern Sie sie erneut als UTF-8 ohne BOM; in PowerShell geben Sie dem schreibenden Befehl eine ausdrückliche Kodierung mit. Eine Datei, die gar kein Text ist, etwa ein in .json umbenanntes Bild, wird mit genau diesem Grund abgelehnt statt mit einem verwirrenden Syntaxfehler.
Gültig, aber falsch: doppelte Schlüssel und lange Zahlen
Zwei Probleme lösen in keinem Parser einen Fehler aus, und deshalb gelangen sie bis in den Produktivbetrieb. Das erste ist ein doppelter Schlüssel. JSON erlaubt denselben Schlüssel zweimal in einem Objekt, und üblicherweise wird der letzte Wert behalten und der erste kommentarlos verworfen: Aus {"a": 1, "a": 2} wird still {"a": 2}. Der Validator meldet jede Wiederholung innerhalb eines Objekts mit einem JSON Pointer dorthin, etwa /users/3/email. Derselbe Schlüssel in zwei verschiedenen Objekten ist normal und wird nicht gemeldet.
Das zweite ist eine Zahl, die zu lang ist, um exakt gespeichert zu werden. Die meisten Parser lesen JSON-Zahlen als 64-Bit-Gleitkommazahl, die ganze Zahlen nur bis 9.007.199.254.740.991 exakt darstellt. 12345678901234567890 kommt als 12345678901234567000 zurück, ohne jeden Fehler. Datenbank-IDs, Bestellnummern und lange Dezimalzahlen sind die typischen Opfer. Der Validator zeigt das exakte Literal neben dem Wert, den ein Parser daraus macht; auch 1e400, das zu Infinity überläuft, wird markiert. Behoben wird das auf der sendenden Seite: Solche Werte als Zeichenketten senden. Beide Prüfungen sind unter Zusätzliche Prüfungen standardmäßig aktiv und lassen sich abschalten.
Die Struktur mit einem JSON Schema prüfen
Gültige Syntax heißt nur, dass sich der Text parsen lässt. Ob er die Felder hat, die ein Programm erwartet, ist eine andere Frage, und die beantwortet ein JSON Schema. Fügen Sie ein Schema in das Feld JSON Schema in den Einstellungen ein, dann wird das Dokument nach der Syntaxprüfung zusätzlich dagegen geprüft. Unterstützt werden Draft 2020-12 und Draft-07; der Draft wird aus $schema gelesen oder, wenn das Schema keinen angibt, angenommen und ausdrücklich genannt. Jeder Verstoß kommt mit JSON Pointer und Zeilennummer und Meldungen wie „Die erforderliche Eigenschaft id fehlt“ oder „Erwartet wurde string, gefunden number“.
Zwei Details überraschen oft. Ein $ref, der auf einen anderen Server zeigt, wird gemeldet, aber nicht abgerufen, damit Ihr Schema auf Ihrem Gerät bleibt; nehmen Sie die Definitionen in das Schema selbst auf. Und "format": "email" ist laut beiden Drafts ein Hinweis, keine Regel, sodass eine falsche Adresse durchgeht, solange Sie nicht format als Regel behandeln, nicht als Hinweis aktivieren. Das Dokument muss zuerst parsen; JSON mit Syntaxfehlern wird nicht gegen ein Schema geprüft.
Logdateien und ein Datensatz pro Zeile
Logs, Datenexporte und Bulk-Anfragen an APIs sind oft NDJSON oder JSON Lines: ein JSON-Wert pro Zeile. Als ein einziges Dokument gelesen, scheitert eine solche Datei mit genau einem nutzlosen Fehler über überzählige Inhalte am Anfang von Zeile 2. Stellen Sie Dokumenttyp auf NDJSON (oder nehmen Sie den Vorschlag an), dann wird jede Zeile als eigener Datensatz geprüft, und jeder Fehler erhält neben Zeile und Spalte seine Datensatznummer. Der abschließende Zeilenumbruch zählt nicht als Datensatz, Windows-Zeilenenden werden berücksichtigt, und eine Leerzeile mittendrin wird gemeldet, weil das Format keine leeren Datensätze kennt. Die Schema-Prüfung gilt für ein einzelnes Dokument und steht im NDJSON-Modus daher nicht zur Verfügung.
Limits in Free und Pro
| Kostenlos | Pro | |
|---|---|---|
| Eingabe | Eingefügter Text oder eine Datei auf einmal | Bis zu 100 Dateien in einem Durchgang |
| Größe | Bis 25 MB | Begrenzt durch Ihr Gerät |
| Prüfungen | Alle Fehler, Warnungen, JSON Schema, NDJSON, Reparatur | Dieselben |
| Bericht | Textbericht zum Kopieren oder Herunterladen | Zusätzlich Berichte als JSON und CSV sowie ein ZIP für einen Stapel |
Alles, was darüber entscheidet, ob ein Dokument gültig ist, ist kostenlos. Ist eine Datei größer als das Limit und brauchen Sie nur einen Teil, können Sie die Struktur im JSON-Viewer durchsehen. Lagen Ihre Daten ursprünglich als YAML oder CSV vor, wandeln Sie sie zuerst mit YAML zu JSON oder CSV zu JSON um. Steht vor jedem Anführungszeichen ein Backslash, wurde das JSON in einer Zeichenkette gespeichert; heben Sie die Maskierung auf und validieren Sie danach.
Häufige Fragen
Wie prüfe ich, ob eine JSON-Datei gültig ist?
Fügen Sie den Text ein oder legen Sie die Datei im JSON-Validator ab und klicken Sie auf Validieren. „Gültiges JSON“ in Grün heißt, dass es dem JSON-Standard (RFC 8259) entspricht; „Ungültiges JSON“ in Rot listet jeden Fehler mit Zeile und Spalte auf.
Warum meldet mein JSON „Unexpected token“ an Position 0?
Meist beginnt die Datei mit einer UTF-8-BOM oder ist als UTF-16 gespeichert, sodass der Parser vor der ersten Klammer auf ein unsichtbares Zeichen trifft. Speichern Sie sie als UTF-8 ohne BOM. Seltener ist die Datei gar kein JSON, etwa eine als .json gespeicherte HTML-Fehlerseite.
Sind Schlusskommas in JSON erlaubt?
Nein. Standard-JSON erlaubt kein Komma vor } oder ]. JSONC und JSON5 erlauben es, deshalb funktioniert dieselbe Datei im Editor und scheitert anderswo. Entfernen Sie das Komma oder übernehmen Sie die reparierte Kopie, die der Validator anbietet.
Kann JSON Kommentare enthalten?
Nicht in Standard-JSON. Dateien mit Kommentaren in // oder /* */ sind JSONC. Der Validator benennt den Dialekt und kann Ihnen eine strikte Kopie ohne Kommentare geben; ein // innerhalb einer Zeichenkette, etwa in einer URL, bleibt unberührt.
Warum ist mein JSON gültig, aber es fehlen Daten?
Sehen Sie sich die Warnungen an. Ein Schlüssel, der in einem Objekt zweimal vorkommt, behält nur seinen letzten Wert, und eine Zahl über 9.007.199.254.740.991 wird beim Parsen gerundet. Beides erzeugt keinen Fehler, und der Validator meldet beides.
Kann ich private JSON-Daten hier sicher online prüfen?
Ja. Die Prüfung läuft auf Ihrem Gerät, nicht auf unseren Servern, sodass API-Antworten, Tokens und Konfigurationsdateien nicht hochgeladen werden. Ist die Seite einmal geladen, funktioniert sie auch ohne Netzwerkverbindung.