HTTP 302 Found: Was es bedeutet

Was dieser Fehler bedeutet und wie du ihn erkennst

• Ein Browser, API-Client, Uptime-Monitor oder HTTP-Checker meldet 302 Found.
• Die Antwort enthält einen Location-Header oder der Client navigiert sichtbar zu einer anderen URL.
• Eine Anfrage scheint im Browser zu funktionieren, schlägt aber in einem API-Client fehl, weil der Client Weiterleitungen anders verarbeitet.
• Eine POST- oder andere Nicht-GET-Anfrage wird weitergeleitet und die Folgeanfrage verhält sich nicht wie erwartet.
• Eine Route, ein Host, eine Request-Methode, ein Authentifizierungsstatus oder ein Client ist betroffen, während andere URLs normal funktionieren.
• DNS kann auflösen und TLS kann gültig sein, weil die Anfrage einen HTTP-fähigen Endpunkt erreicht hat; diese Prüfungen sind von der Weiterleitungsantwort getrennt.

Hauptursachen nach Wahrscheinlichkeit

1. Beabsichtigtes temporäres Routing: Die Anwendung oder der Webserver leitet Benutzer während einer vorübergehenden Änderung oder eines Anwendungsablaufs von einer URL zu einer anderen weiter.
2. Authentifizierung oder Sitzungsverwaltung: Eine nicht authentifizierte Anfrage wird zu einer Anmelde- oder sitzungsbezogenen Route weitergeleitet.
3. Anwendungslogik: Eine Route, Sprachauswahl, ein Formularablauf, ein Feature-Flag oder eine Regel für den Anfragezustand gibt für bestimmte Benutzer oder Methoden eine Weiterleitung zurück.
4. Konfiguration von Reverse Proxy, CDN oder WAF: Ein zwischengeschaltetes System wendet eine Weiterleitung an, bevor die Anfrage die Ursprungsanwendung erreicht.
5. Caching oder veraltete Konfiguration: Eine zwischengespeicherte Antwort oder eine kürzlich geänderte Routing-Regel erzeugt weiterhin eine unerwartete Weiterleitung.
6. Abweichung bei Methode oder Weiterleitungssemantik: Ein 302 ist möglicherweise nicht geeignet, wenn die Folgeanfrage die ursprüngliche Methode und den Request-Body beibehalten muss; das Client-Verhalten sollte geprüft werden, bevor der Status geändert wird.

Der Statuscode allein zeigt nicht, welche Komponente die Antwort erzeugt hat, und beweist nicht, dass die gesamte Website fehlerhaft ist.

So behebst du den Fehler

Für Besucher und API-Nutzer

1. Wiederholen Sie die exakte URL einmal und bestätigen Sie Schema, Hostname, Pfad, Query-String und Schreibweise.
2. Prüfen Sie, ob der Client Weiterleitungen automatisch verfolgt. Falls ja, vergleichen Sie die ursprüngliche 302-Antwort mit der finalen Antwort, statt nur die finale Seite anzusehen.
3. Wenn die Route eine Authentifizierung erfordert, melden Sie sich über den normalen Ablauf der Website an und versuchen Sie es erneut. Geben Sie keine Zugangsdaten an ein unbekanntes Ziel weiter.
4. Wenn eine API-Anfrage betroffen ist, notieren Sie Methode, Anfrage-URL, Antwortstatus, Location-Wert und finale Antwort. Gehen Sie nicht davon aus, dass eine Browser-Weiterleitung für eine API gültiges Verhalten ist.
5. Vermeiden Sie wiederholtes Aktualisieren, wenn das Ziel fehlschlägt oder der Dienst Anfragelimits anwendet.
6. Wenn die Weiterleitung weiterhin unerwartet ist, senden Sie dem Website-Betreiber URL, Methode, Zeitstempel, Client-Verhalten und bereinigte Antwortdetails. Teilen Sie keine Passwörter, Cookies, Authorization-Header oder API-Secrets.

Für Website-Betreiber und Entwickler

1. Reproduzieren Sie die exakte Anfrage. Erfassen Sie HTTP-Methode, vollständige URL, Host, Authentifizierungsstatus, User-Agent, Status, Location-Header und ob der Client der Weiterleitung gefolgt ist. Die finale Browserseite kann den ursprünglichen 302 verbergen.
2. Ermitteln Sie, ob die Weiterleitung beabsichtigt ist. Vergleichen Sie Route und Methode mit dem dokumentierten Routing sowie den Abläufen für Authentifizierung, Sprache, Wartung und Anwendung.
3. Finden Sie die erzeugende Ebene. Prüfen Sie Antwort-Header und korrelieren Sie den Anfragezeitpunkt mit den Logs von Anwendung, Webserver, Reverse Proxy, CDN und WAF. Testen Sie einen Origin-Pfad separat nur, wenn Ihre Infrastruktur und Autorisierung dies erlauben.
4. Prüfen Sie das Weiterleitungsziel. Bestätigen Sie, dass der Location-Wert das vorgesehene Schema, den Host, den Pfad und die Query-Parameter verwendet. Achten Sie auf Weiterleitungsketten, Schleifen, einen unbeabsichtigten Hostnamen oder ein Ziel, das einen Fehler zurückgibt.
5. Vergleichen Sie die Request-Methoden. Testen Sie die betroffene Methode getrennt von GET. Wenn die Anfrage Methode und Body beibehalten muss, prüfen Sie, ob laut Anwendungsdesign und Client-Verhalten ein methodenerhaltender Weiterleitungsstatus erforderlich ist.
6. Prüfen Sie kürzliche Änderungen. Vergleichen Sie Deployments und Änderungen an Routing, Authentifizierung, Sitzungsverwaltung, Proxy-Regeln, CDN-Verhalten, WAF-Richtlinien und Caching.
7. Wenden Sie die kleinste sichere Korrektur an. Ändern Sie nur die verantwortliche Regel oder Komponente – mit entsprechender Autorisierung und einem Rollback-Plan. Deaktivieren Sie Authentifizierungs- oder Sicherheitskontrollen nicht einfach, um einen 302 zu entfernen.
8. Testen Sie dieselbe Anfrage erneut. Bestätigen Sie den vorgesehenen Status, das Ziel, die Methodenverarbeitung, die Header und die finale Antwort. Testen Sie anschließend verwandte Routen, authentifizierte und nicht authentifizierte Zustände sowie wichtige API-Methoden.

Vorbeugung und Überprüfung der Lösung

• Überwachen Sie Weiterleitungsraten nach Route, HTTP-Methode, Host, Antwortstatus und Deployment, damit unerwartete 302-Änderungen sichtbar werden.
• Halten Sie die Konfiguration von Anwendungsrouting, Authentifizierung, Proxy, CDN, WAF und Caching versionskontrolliert.
• Testen Sie nach Releases sowohl die ursprüngliche Antwort als auch das finale Ziel für wichtige Seiten und API-Endpunkte.
• Beziehen Sie authentifizierte, nicht authentifizierte und Nicht-GET-Anfragen ein, sofern diese Pfade unterstützt werden.
• Dokumentieren Sie beabsichtigte temporäre Weiterleitungen, ihre Ziele, betroffenen Methoden sowie geplante Entfernung oder Überprüfung.
• Bewahren Sie angemessen bereinigte Server- und Anwendungslogs lange genug auf, um Weiterleitungsprobleme zu korrelieren.
• Prüfen Sie bei Konfigurations-Reviews Weiterleitungsketten und die Zuständigkeit für Ziele, um Schleifen und unbeabsichtigte Hoständerungen zu verhindern.

Häufig gestellte Fragen