HTTP 505 HTTP-Version nicht unterstützt: Bedeutung und Behebung

Was dieser Fehler bedeutet und wie du ihn erkennst

• Ein Browser, API-Client, Monitoring-System oder Command-Line-Tool empfängt 505 HTTP Version Not Supported.
• Die Antwort kann eine Meldung enthalten, dass die angeforderte HTTP-Version nicht unterstützt wird.
• DNS kann erfolgreich aufgelöst werden und TLS kann erfolgreich abgeschlossen werden, da der Client anschließend eine HTTP-Antwort erhalten hat.
• Der Fehler kann nur bei einem bestimmten Client, einem Protokoll-Aushandlungspfad, einer URL, einer HTTP-Methode oder einem Zwischenserver auftreten.
• Response-Header können zeigen, ob die Antwort von einem Proxy, CDN, Load Balancer oder Origin-Server stammt, und Hinweise auf Caching oder Verbindungsdetails enthalten.

Hauptursachen nach Wahrscheinlichkeit

1. Nicht unterstützte HTTP-Protokollversion: Der Endpunkt unterstützt die in der Anfrage verwendete Hauptversion des HTTP-Protokolls nicht. Dies ist die maßgebliche Ursache für den Status 505.
2. Protokollkonflikt zwischen einem Zwischenserver und seinem Upstream: Ein Reverse Proxy, CDN, Load Balancer oder Gateway kann eine Protokollversion verwenden, die der nächste Server nicht akzeptiert, oder selbst eine 505-Antwort zurückgeben.
3. Fehlerhafte oder unvollständige HTTP-Protokollkonfiguration: Eine kürzlich vorgenommene Änderung am Server, Proxy oder in der Anwendung kann eine Protokollversion aktiviert oder vorausgesetzt haben, die nicht im gesamten Anfragepfad unterstützt wird.
4. Client-spezifische Aushandlung oder Anfrageverhalten: Ein Client oder Monitoring-Tool kann ein anderes HTTP-Protokoll auswählen als Browser oder andere Clients und dadurch ein Kompatibilitätsproblem sichtbar machen.
5. Unerwartete Antwort von einer Nicht-Origin-Ebene: Der Status kann von einem Gateway oder Sicherheits-Zwischenserver und nicht von der Anwendung erzeugt werden, der die URL gehört. Header und Logs sind erforderlich, um dies von einer Antwort des Origin-Servers zu unterscheiden.

Authentifizierung, Rate Limits, DNS und TLS können eine Anfrage beeinflussen, erklären eine HTTP-505-Antwort jedoch nicht von selbst. Behandeln Sie sie als separate Untersuchungswege, sofern Response-Header oder Logs keinen Zusammenhang mit dem Fehler der Protokollversion herstellen.

So behebst du den Fehler

Für Besucher und API-Nutzer

1. Rufen Sie die genaue URL einmal erneut auf und prüfen Sie, ob der Client aktuell und für eine normale HTTP-Anfrage konfiguriert ist.
2. Wenn das Problem in einem API-Client oder Monitoring-Tool auftritt, vergleichen Sie das Ergebnis mit einem anderen unterstützten Client. Halten Sie fest, ob der Fehler client-spezifisch ist.
3. Notieren Sie URL, HTTP-Methode, ungefähre Uhrzeit, Antwortstatus und Response-Header. Fügen Sie keine Passwörter, Cookies, Autorisierungstoken oder andere Geheimnisse ein.
4. Wenn der Fehler bestehen bleibt, senden Sie diese bereinigten Angaben an den Betreiber der Website oder API. Ein Besucher kann ein serverseitiges Protokollkompatibilitätsproblem in der Regel nicht selbst beheben.

Für Entwickler und Website-Betreiber

1. Erfassen Sie die genaue Anfrage. Protokollieren Sie Hostname, Pfad, Methode, Anfrageprotokoll, Client, Zeitstempel und finalen Status. Bestätigen Sie, dass die Antwort tatsächlich 505 und nicht eine Weiterleitung oder ein von einem Client nach einem anderen Fehler angezeigter Status ist.
2. Prüfen Sie die Protokollaushandlung. Ermitteln Sie, welche HTTP-Version der Client verwendet oder zu verwenden versucht und welche Version der Endpunkt, Proxy, Load Balancer oder CDN unterstützt. Prüfen Sie bei verschlüsselten Verbindungen das ausgehandelte Anwendungsprotokoll, sofern Ihre Tools dies anzeigen.
3. Identifizieren Sie die Antwort-Ebene. Verwenden Sie Response-Header, verfügbare Server-Signaturen, Anfragekennungen und Access-Logs, um festzustellen, ob die 505-Antwort vom CDN, WAF, Gateway, Reverse Proxy, Webserver oder von der Anwendung stammt.
4. Korrelieren Sie die Logs. Suchen Sie auf der identifizierten Ebene und der Upstream-Ebene nach demselben Zeitstempel, derselben Route, Methode, demselben Client und derselben Anfrage-ID. Ein fehlender Origin-Logeintrag kann darauf hindeuten, dass ein Zwischenserver die Anfrage vor der Weiterleitung abgelehnt hat.
5. Prüfen Sie kürzliche Protokolländerungen. Kontrollieren Sie aktuelle Deployments und Konfigurationsänderungen, die die HTTP-Versionsunterstützung, Proxy-zu-Origin-Verbindungen, Load-Balancer-Listener, Gateway-Routing sowie Client- oder Monitoring-Konfigurationen betreffen.
6. Wenden Sie die kleinste autorisierte Korrektur an. Stimmen Sie den betroffenen Client, Zwischenserver und Origin auf eine Protokollversion ab, die im gesamten Anfragepfad unterstützt wird. Deaktivieren Sie TLS-Validierung, Authentifizierung oder Sicherheitskontrollen nicht als Workaround.
7. Testen Sie dieselbe Anfrage erneut. Überprüfen Sie die ursprüngliche URL und Methode und testen Sie anschließend repräsentative Routen und Protokollpfade. Bestätigen Sie, dass die Korrektur keine unabhängigen Statuscodes oder Routing-Verhalten verändert hat.
8. Verwenden Sie für gemeinsam genutzte Infrastruktur einen kontrollierten Rollout. Wenn die betroffene Einstellung viele Websites oder Routen bedient, testen Sie sie in einem freigegebenen Staging- oder begrenzten Änderungsumfang, bevor Sie sie umfassend anwenden. Befolgen Sie die Änderungs- und Rollback-Verfahren der Umgebung.

Vorbeugung und Überprüfung der Lösung

• Dokumentieren Sie die von Clients, Gateways, Proxies, Load Balancern und Origins unterstützten HTTP-Versionen für jeden Anfragepfad.
• Testen Sie wichtige Browser-Routen und API-Methoden nach Änderungen an Protokollen oder Infrastruktur über den tatsächlichen produktionsnahen Proxy- und CDN-Pfad.
• Überwachen Sie Statuscodes nach Route, Clienttyp, Protokoll und Deployment, damit client-spezifische 505-Antworten sichtbar werden.
• Halten Sie die Konfiguration von Proxy, Load Balancer, Webserver und Anwendung versionskontrolliert und sorgen Sie für einen getesteten Rollback-Pfad.
• Bewahren Sie korrelierte Access- und Gateway-Logs lange genug auf, um die Ebene zu identifizieren, die eine unerwartete Antwort erzeugt hat.
• Halten Sie Monitoring-Tools und API-Clients aktuell und überprüfen Sie ihre Protokolleinstellungen bei der Einführung oder bei Konfigurationsänderungen.

Häufig gestellte Fragen