HTTP 422 Nicht verarbeitbarer Inhalt
422 Unprocessable Content bedeutet, dass die Anfrage formal korrekt ist, die enthaltenen Daten jedoch nicht verarbeitet werden können.
Bedeutung
Der Server versteht das Format, etwa gültiges JSON, aber die Inhalte verletzen Regeln: Ein Pflichtfeld fehlt, eine E-Mail-Adresse ist ungültig oder ein Datum liegt außerhalb des erlaubten Bereichs. 422 wird häufig von REST-APIs und Frameworks wie Rails, Laravel und FastAPI für Validierungsfehler verwendet.
Häufige Ursachen
- Ein benötigtes Feld fehlt oder wurde leer übermittelt.
- Ein Wert besitzt das falsche Format, etwa E-Mail, Telefonnummer oder Datum.
- Ein Wert liegt außerhalb des zulässigen Bereichs.
- Eine Geschäftsregel der Anwendung erlaubt die gewünschte Aktion nicht.
Was können Besucher tun?
- Kontrollieren Sie die Formulareingaben, besonders die als fehlerhaft markierten Felder, und korrigieren Sie diese.
Was können Betreiber tun?
- Geben Sie eine Liste der betroffenen Felder und verständliche Fehlermeldungen in der API-Antwort zurück.
- Nutzen Sie 400 bei fehlerhaft lesbaren Anfragen und 422 bei formal gültigen, aber inhaltlich ungültigen Daten.
- Validieren Sie Eingaben zur besseren Bedienbarkeit auch im Browser und zusätzlich verpflichtend auf dem Server.
SEO-Auswirkungen
422 tritt normalerweise in Formularen und APIs auf und hat keinen direkten Einfluss auf die Indexierung regulärer öffentlicher Webseiten.
Häufige Fragen
Wann 400 und wann 422 verwenden?
400 steht für eine fehlerhaft aufgebaute Anfrage; 422 für eine formal korrekte Anfrage mit ungültigen Daten.
Warum liefert FastAPI einen HTTP-422-Fehler?
Weil die übermittelten Daten nicht zum erwarteten Modell passen, etwa wegen falscher Datentypen oder fehlender Pflichtfelder.