HTTP 415 Unsupported Media Type: Bedeutung und Behebung

Was dieser Fehler bedeutet und wie du ihn erkennst

• Ein API-Client, Browserformular, Upload-Tool, Monitoring-Check oder eine Anwendung meldet 415 Unsupported Media Type.
• Die Antwort kann einen einzelnen Endpunkt, eine HTTP-Methode oder ein Anfrageformat betreffen, während andere Seiten und Routen weiterhin funktionieren.
• Eine Anfrage kann fehlschlagen, nachdem das Body-Format, Content-Type, die Inhaltscodierung, der Upload-Typ oder die Client-Bibliothek geändert wurde.
• Response-Header können den Server, Proxy oder CDN erkennen lassen, der die Antwort erzeugt hat, sowie Hinweise auf Caching, Authentifizierung, Weiterleitungen oder Rate-Limits liefern.
• DNS-Auflösung und TLS-Aushandlung können erfolgreich sein, weil eine HTTP-Antwort empfangen wurde. Diese Prüfungen beweisen jedoch nicht, dass der Anfrageinhalt akzeptiert wurde.

Hauptursachen nach Wahrscheinlichkeit

1. Nicht unterstützter Medientyp der Anfrage: Der Endpunkt akzeptiert den in Content-Type gesendeten Wert nicht, etwa wenn Formulardaten an eine Route gesendet werden, die nur JSON akzeptiert.
2. Fehlender oder falscher Request-Header: Der Client lässt Content-Type weg, sendet einen Tippfehler oder kennzeichnet den Body anders als dessen tatsächliches Format.
3. Nicht unterstützte Inhaltscodierung: Die Anfrage verwendet eine Komprimierungs- oder Transfercodierung, die die empfangende Komponente nicht verarbeiten kann.
4. Falscher Endpunkt oder falsche Methode: Eine Anfrage wird an eine Route gesendet, die eine andere Darstellung, ein anderes Upload-Format oder eine andere HTTP-Methode erwartet.
5. Validierung durch Proxy, CDN, WAF oder Webserver: Ein Vermittler lehnt die Anfrage ab, bevor sie die Anwendung erreicht, oder wendet Regeln an, die von den dokumentierten Anforderungen der Anwendung abweichen.
6. Kürzliche Änderung an Anwendung oder Konfiguration: Ein Deployment, eine Routing-Änderung, eine Parser-Aktualisierung, eine Authentifizierungsintegration oder eine Proxy-Regel verändert, welche Anfrageformate akzeptiert werden.

Der Statuscode allein identifiziert die verantwortliche Komponente nicht. Bestätigen Sie die Anfragedetails und die dazugehörigen Logs, bevor Sie Authentifizierung, Berechtigungen, Limits oder die Upstream-Konfiguration als Ursache ansehen.

So behebst du den Fehler

Für Besucher und nicht technische Nutzer

1. Wiederholen Sie die genaue Aktion einmal. Bestätigen Sie die URL und gegebenenfalls die von Ihnen ausgewählte Upload- oder Formularaktion. Vermeiden Sie es, dieselbe Anfrage wiederholt abzusenden.
2. Verwenden Sie den normalen Anmeldevorgang. Wenn der Endpunkt ein Konto erfordert, melden Sie sich über die reguläre Benutzeroberfläche der Website an, statt Request-Header oder Cookies manuell zu ändern.
3. Prüfen Sie die übermittelte Datei oder den Inhalt. Wenn der Fehler beim Upload oder Absenden eines Formulars auftritt, verwenden Sie das von der Website verlangte Format. Benennen Sie eine Datei nicht einfach um, ohne sie zu konvertieren.
4. Probieren Sie die unterstützte Oberfläche der Website. Wenn ein API-Tool, eine Browser-Erweiterung oder eine benutzerdefinierte Integration fehlschlägt, vergleichen Sie sie mit dem normalen Webformular oder der Anwendung der Website.
5. Wenden Sie sich an den Website-Betreiber, wenn der Fehler bestehen bleibt. Geben Sie die betroffene URL oder Funktion, die ungefähre Uhrzeit, das Ergebnis HTTP 415 und die fehlgeschlagene Aktion an. Senden Sie keine Passwörter, Cookies, Autorisierungstokens oder privaten Dateiinhalte.

Für Entwickler und API-Clients

1. Erfassen Sie die vollständige Struktur der Anfrage. Notieren Sie Methode, URL-Pfad, Query-Parameter, Content-Type, Inhaltscodierung, den relevanten Accept-Wert und eine bereinigte Beschreibung des Bodys. Protokollieren Sie Geheimnisse oder personenbezogene Daten nicht unnötig.
2. Vergleichen Sie die Anfrage mit dem Vertrag des Endpunkts. Prüfen Sie, ob Route und Methode die gesendete Darstellung akzeptieren. Klären Sie beispielsweise, ob der Endpunkt JSON, form-codierte Daten, Multipart-Formulardaten, XML oder ein bestimmtes Upload-Format erwartet.
3. Stimmen Sie die Deklaration auf den Body ab. Kennzeichnen Sie Formulardaten nicht als JSON und senden Sie keinen komprimierten Body ohne die entsprechende unterstützte Codierung. Lassen Sie die Client-Bibliothek Multipart-Grenzen erzeugen, wenn sie diese Funktion anbietet.
4. Verwenden Sie eine minimale Reproduktion. Entfernen Sie nach Möglichkeit optionale Felder und nicht relevante Middleware. Wiederholen Sie anschließend dieselbe Anfrage mit einem bekanntermaßen unterstützten Body. Bewahren Sie die ursprüngliche Anfrage zum Vergleich auf.
5. Untersuchen Sie die Antwort. Prüfen Sie Status, Content-Type, Caching-Indikatoren, Server- oder Proxy-Kennungen, Weiterleitungen und den Fehler-Body, falls vorhanden. Eine von einem Gateway erzeugte Antwort muss nicht die Validierung der Anwendung widerspiegeln.
6. Prüfen Sie die Logs der verantwortlichen Ebene. Gleichen Sie Zeitstempel, Route und Korrelations- oder Request-ID mit den Logs von Anwendung, Webserver, Reverse Proxy, CDN oder WAF ab.
7. Wenden Sie die engste passende Korrektur an. Korrigieren Sie den Client-Header, Serializer, das Upload-Format, den Routenvertrag oder eine eng begrenzte Regel für den Vermittler. Deaktivieren Sie nicht als erste Reaktion allgemein Validierung, Authentifizierung oder Sicherheitsfilter.
8. Testen Sie erneut und prüfen Sie angrenzendes Verhalten. Wiederholen Sie die ursprüngliche Anfrage. Testen Sie anschließend denselben Endpunkt mit seinen unterstützten Formaten und stellen Sie sicher, dass zugehörige Routen weiterhin ihre vorgesehenen Statuscodes zurückgeben.

Für Website-Betreiber und Administratoren

1. Reproduzieren Sie den Fehler mit demselben Client-Typ und derselben Anfragemethode und erfassen Sie bereinigte Header sowie Zeitangaben.
2. Ermitteln Sie durch den Vergleich von Response-Headern und Logs auf jeder Ebene, ob die 415-Antwort von Anwendung, Webserver, Reverse Proxy, CDN oder WAF erzeugt wurde.
3. Prüfen Sie kürzliche Deployments und Änderungen an Routing, Anfrageverarbeitung, Upload-Verarbeitung, Proxy-Weiterleitung, Inhaltscodierung und Sicherheitsregeln.
4. Stellen Sie sicher, dass Caches oder Vermittler keine unpassende gespeicherte Antwort für die Anfrage ausliefern.
5. Korrigieren Sie die spezifische Route oder den Client-Vertrag, dokumentieren Sie die akzeptierten Formate und bewahren Sie genügend Logs auf, um die Behebung zu bestätigen.
6. Wenn die Anfrage absichtlich nicht unterstützt wird, stellen Sie sicher, dass das Verhalten des Endpunkts und die Dokumentation für Clients das akzeptierte Format eindeutig angeben.

Vorbeugung und Überprüfung der Lösung

• Dokumentieren Sie für jeden wichtigen Endpunkt die akzeptierten HTTP-Methoden, Medientypen, Codierungen und Upload-Formate.
• Verwenden Sie nach Änderungen an Anwendung oder Proxy automatisierte Tests für repräsentative JSON-, Formular-, Multipart- und andere unterstützte Anfragearten.
• Halten Sie Routing-, Anfrageverarbeitungs-, Proxy-, CDN- und WAF-Konfigurationen mit nachvollziehbaren Änderungen unter Versionskontrolle.
• Überwachen Sie Statuscodes nach Route und Methode, statt alle 4xx-Antworten als eine einzige Kategorie zu behandeln.
• Halten Sie Korrelations-IDs sowie angemessen bereinigte Anwendungs- und Vermittler-Logs für den relevanten Aufbewahrungszeitraum verfügbar.
• Sorgen Sie dafür, dass Client-Integrationen bei Änderungen der vom Server akzeptierten Medientypen eindeutig fehlschlagen, und testen Sie sie gegen den dokumentierten Vertrag.

Häufig gestellte Fragen