JSON-Validierung: So validieren und reparieren Sie JSON-Daten

JSON (JavaScript Object Notation) ist das am weitesten verbreitete Datenaustauschformat im Web. Von API-Antworten bis zu Konfigurationsdateien — JSON ist überall. Aber JSON ist streng in seiner Syntax — ein einziges falsch gesetztes Komma oder ein fehlendes Anführungszeichen kann einen gesamten Parser zum Absturz bringen. Dieser Leitfaden behandelt alles, was Sie über JSON-Validierung, häufige Fehler und deren Behebung wissen müssen.

Warum JSON-Validierung wichtig ist

Ungültiges JSON kann eine Vielzahl von Problemen verursachen:

• API-Fehler: Ein Server, der ungültiges JSON zurückgibt, lässt clientseitige Parser abstürzen und zerbricht Anwendungen.
• Konfigurationsfehler: Fehlerhaftes JSON in Konfigurationsdateien (wie package.json, composer.json oder tsconfig.json) kann Tools am Ausführen hindern.
• Datenkorruption: Der Import oder Export von Daten mit JSON-Fehlern kann zu stillem Datenverlust führen.
• Debugging-Aufwand: Das Aufspüren ungültiger JSON in großen Dateien ohne geeignete Werkzeuge ist zeitaufwändig und fehleranfällig.

Das Validieren von JSON vor der Verwendung in der Produktion spart Zeit und verhindert Fehler. Ein guter Validator prüft nicht nur die Syntax, sondern auch die strukturelle Konsistenz.

Was macht JSON gültig oder ungültig?

Die JSON-Syntax folgt strengen Regeln. Hier sind die häufigsten Validierungsanforderungen:

Gültige JSON-Regeln

• Zeichenketten müssen in doppelten Anführungszeichen stehen (einfache Anführungszeichen sind nicht erlaubt).
• Schlüssel müssen doppelt angeführte Zeichenketten sein (nicht angeführte Bezeichner sind ungültig).
• Zahlen können Ganzzahlen oder Dezimalzahlen sein, aber führende Nullen sind nicht erlaubt (z.B. ist 01 ungültig).
• Boolesche Werte müssen klein geschrieben sein: true, false.
• Null-Werte müssen klein geschrieben sein: null.
• Keine nachgestellten Kommas in Objekten oder Arrays sind erlaubt.
• Kommentare sind in Standard-JSON nicht erlaubt.

Beispiel für gültiges JSON

{
  "name": "Alice",
  "age": 30,
  "isActive": true,
  "roles": ["admin", "editor"],
  "address": {
    "city": "New York",
    "zip": "10001"
  }
}

Beispiel für ungültiges JSON

{
  name: "Alice",       // Fehlende Anführungszeichen um Schlüssel
  'age': 30,           // Einfache statt doppelte Anführungszeichen
  "isActive": true,    // Nachgestelltes Komma
  "roles": ["admin"],, // Doppeltes Komma
  "note": undefined    // undefined ist kein gültiges JSON
}

Häufige JSON-Fehler

So validieren Sie JSON

Online-JSON-Validator

Der einfachste Weg, JSON zu validieren, ist die Verwendung eines Online-Tools. Der JSON-Validator & Repair auf Help2Code prüft Ihre JSON-Syntax in Echtzeit und liefert detaillierte Fehlermeldungen, die direkt auf die Problemstelle verweisen.

Funktionen umfassen:

• Echtzeit-Validierung während der Eingabe
• Zeilen- und Spaltennummern für jeden Fehler
• Verständliche Fehlerbeschreibungen
• Automatische Reparaturvorschläge für häufige Probleme
• Option zum Minifizieren oder Verschönern der Ausgabe
• JSON-Schema-Validierungsunterstützung

JSON in Code validieren

JavaScript (Browser / Node.js):

try {
  const data = JSON.parse(jsonString);
  console.log('Gültiges JSON:', data);
} catch (error) {
  console.error('Ungültiges JSON:', error.message);
}

Python:

import json

def validate_json(data):
    try:
        json.loads(data)
        return True, None
    except json.JSONDecodeError as e:
        return False, str(e)

is_valid, error = validate_json('{"name": "Alice"}')
print(error if not is_valid else "Gültig!")

PHP:

function validateJson($string) {
    json_decode($string);
    return json_last_error() === JSON_ERROR_NONE;
}

Kommandozeile (jq):

# JSON-Datei validieren (Rückgabecode 0 wenn gültig)
jq . datei.json > /dev/null && echo "Gültig" || echo "Ungültig"

# Den spezifischen Fehler anzeigen
jq . datei.json 2>&1

JSON-Schema-Validierung

Über die Syntaxvalidierung hinaus definiert JSON Schema die Struktur und Datentypen, die Ihr JSON haben sollte. Ein JSON Schema ist selbst ein JSON-Dokument, das beschreibt:

• Erforderliche und optionale Felder
• Datentypen (String, Number, Boolean, Array, Object, Null)
• Zeichenkettenmuster und Formate (E-Mail, Datum, URI)
• Minimal- und Maximalwerte für Zahlen
• Array-Längenbeschränkungen

Der JSON-Schema-Validator auf Help2Code validiert Ihre JSON-Daten gegen ein Schema, um strukturelle Korrektheit sicherzustellen.

Beispiel JSON Schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": ["name", "email"],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1
    },
    "email": {
      "type": "string",
      "format": "email"
    },
    "age": {
      "type": "integer",
      "minimum": 0,
      "maximum": 150
    }
  }
}

So reparieren Sie ungültiges JSON

Einige JSON-Fehler können automatisch repariert werden. Häufige Reparaturstrategien sind:

1. Nachgestellte Kommas entfernen: Entfernen Sie Kommas vor schließenden Klammern oder geschweiften Klammern.
2. Fehlende Anführungszeichen hinzufügen: Nicht angeführte Schlüssel und einfach angeführte Zeichenketten automatisch in doppelte Anführungszeichen setzen.
3. Maskierte Zeichen korrigieren: Fehlerhaft maskierte Steuerzeichen korrigieren.
4. Kommentare entfernen: JavaScript-artige Kommentare entfernen (sowohl // als auch /* */).
5. Einfache in doppelte Anführungszeichen umwandeln: Alle einfach angeführten Zeichenketten durch doppelt angeführte ersetzen.
6. Nachgestellten Text entfernen: Text nach der letzten schließenden Klammer entfernen.

Der JSON-Validator & Repair wendet diese Korrekturen automatisch an und zeigt Ihnen das reparierte JSON neben dem Original an.

Best Practices für die Arbeit mit JSON

• Vor dem Parsen immer validieren: Gehen Sie nie davon aus, dass externe JSON-Daten gültig sind. Verwenden Sie immer Fehlerbehandlung beim Parsen.
• Einen Linter im Editor verwenden: Die meisten Code-Editoren haben JSON-Linter, die Fehler während der Eingabe hervorheben.
• Für Lesbarkeit formatieren: Formatiertes JSON ist visuell leichter zu validieren. Verwenden Sie 2-Leerzeichen-Einrückung als Standard.
• Manuelle Bearbeitung großer JSON-Dateien vermeiden: Verwenden Sie Tools zur programmatischen Generierung oder Änderung von JSON, um menschliche Fehler zu vermeiden.
• JSON Schema für API-Verträge verwenden: Definieren und erzwingen Sie die erwartete Struktur Ihrer JSON-Daten mit Schemas.
• JSON-Dateien unter Versionskontrolle halten: Konfigurationsdateien und Test-Fixtures profitieren von Git-Verlauf und Code-Review.

Fazit

JSON-Validierung ist eine wesentliche Fähigkeit für jeden Entwickler, der mit modernen Webtechnologien arbeitet. Das Verständnis der Syntaxregeln, häufigen Fehler und verfügbaren Tools hilft Ihnen, Probleme frühzeitig zu erkennen und zu beheben. Verwenden Sie den JSON-Validator & Repair, um Ihr JSON sofort zu prüfen, und validieren Sie immer externe Daten, bevor Sie ihnen in Ihren Anwendungen vertrauen.