Sie besuchen Ihre Website und sehen einen weißen Bildschirm mit drei Worten: „502 Bad Gateway". Der Traffic fließt, aber Besucher sehen einen Fehler statt Inhalt. Verkäufe stocken, SEO-Rankings rutschen ab, und Sie verschwenden Zeit mit Raten.

Der 502-Fehler sieht beängstigend aus, aber technisch betrachtet handelt es sich lediglich um eine Kommunikationsstörung zwischen Servern. Ihre Website ist nicht kaputt, Daten sind nicht verschwunden, und in den meisten Fällen dauert die Behebung fünf bis fünfzehn Minuten. Nachfolgend finden Sie eine Schritt-für-Schritt-Anleitung, die Sie von den einfachsten Prüfungen bis zur tiefergehenden Diagnose führt.

💡 Kurzübersicht:

• Aktualisieren Sie die Seite und prüfen Sie, ob der Hosting-Server ausgefallen ist
• Leeren Sie Ihren Browser-Cache und deaktivieren Sie vorübergehend das CDN
• Falls der Fehler bestehen bleibt, deaktivieren Sie Plugins per FTP und überprüfen Sie das Theme
• Setzen Sie die .htaccess zurück und kontaktieren Sie Ihren Hoster, wenn alles andere fehlschlägt

Was ist ein 502-Bad-Gateway-Fehler

Wenn Sie eine Website öffnen, sendet der Browser eine HTTP-Anfrage. Serverseitig empfängt ein Reverse-Proxy (Nginx, Apache) diese und verteilt die Anfragen auf den Anwendungsserver (PHP), die Datenbank, den statischen Webserver und das CDN. Jeder Knoten bearbeitet seinen Teil und liefert das Ergebnis an den Proxy-Server zurück. Der Proxy setzt die Antwort zusammen, liefert sie an den Browser aus, und die Seite lädt.

Ein 502-Fehler tritt auf, wenn einer der Server in dieser Kette eine ungültige Antwort an den Proxy-Server zurücksendet. Der Proxy kann die Seite nicht zusammenstellen und zeigt „Bad Gateway" an. Der Browser meldet ehrlich, dass das Gateway zwischen den Servern etwas Unerwartetes empfangen hat.

Äußerlich kann der Fehler verschiedene Formen annehmen: „502 Bad Gateway", „502 Service Temporarily Overloaded", „HTTP 502", „Nginx 502 Bad Gateway", „Proxy Error". Der Kern ist derselbe: Irgendwo in der Kette gibt es einen Bruch.

Warum der 502-Fehler auftritt

Die Ursachen liegen fast immer serverseitig, aber manchmal lösen auch Ihre eigenen Aktionen auf der Website ihn aus:

• Serverüberlastung. Eine plötzliche Traffic-Spitze erschöpft die Hosting-Ressourcen, und die PHP-Prozesse kommen mit der Anfragewarteschlange nicht mehr hinterher.
• Fehlerhaftes Plugin oder Theme. Code, der einen fatalen PHP-Fehler verursacht, beendet die Antwort des Anwendungsservers vorzeitig, und der Proxy erhält nichts.
• CDN-Probleme. Cloudflare, KeyCDN oder ein anderer Content-Delivery-Dienst kann keine Verbindung zum Origin-Server herstellen und liefert einen 502.
• Fehlerhafte DNS-Einträge. Nach einem Hoster-Wechsel oder der Aktualisierung von DNS-Servern sind die Einträge noch nicht propagiert, sodass die Website vorübergehend nicht erreichbar ist.
• Beschädigte.htaccess. Fehlerhafte Syntax oder widersprüchliche Rewrite-Regeln stören die Anfrageverarbeitung.
• PHP-Speicherlimit erschöpft. Ein schweres Plugin oder Skript verbraucht den gesamten verfügbaren Arbeitsspeicher, und der Prozess stürzt ab.

Gehen wir nun die einzelnen Behebungsschritte der Reihe nach durch, vom schnellsten bis zum komplexeren.

Schritt 1. Seite aktualisieren

Der erste und einfachste Schritt: Drücken Sie F5 oder Strg+R. Wenn der Fehler durch eine kurze Serverstörung verursacht wurde, wird die wiederholte Anfrage erfolgreich sein. Versuchen Sie, die Website in einem anderen Browser oder über mobile Daten zu öffnen; das schließt ein Problem auf Ihrer Seite aus.

Prüfen Sie mit isup.me oder Down For Everyone Or Just Me, ob die Website für den Rest der Welt funktioniert. Zeigt der Dienst an, dass die Website nur für Sie nicht erreichbar ist, liegt das Problem lokal, machen Sie also weiter. Ist die Website für alle nicht verfügbar, ist der Hosting-Server höchstwahrscheinlich abgestürzt oder es wurde eine Sperre auf Provider-Ebene angewendet.

Schritt 2. Browser-Cache leeren

Der Browser speichert nicht nur Bilder und Stylesheets, sondern auch fehlerhafte Serverantworten im Cache. Ein harter Refresh (Strg+F5 unter Windows, Cmd+Umschalt+R unter macOS) zwingt den Browser, die Seite unter Umgehung des lokalen Caches erneut anzufordern.

Wenn ein harter Refresh nicht geholfen hat, leeren Sie den Cache vollständig. In Chrome: Einstellungen → Datenschutz und Sicherheit → Browserdaten löschen → „Bilder und Dateien im Cache". Ausführliche Anleitungen für verschiedene Browser und das Leeren des Caches auf WordPress-Seite haben wir in einem separaten Leitfaden zusammengestellt.

Schritt 3. CDN vorübergehend deaktivieren

Content-Delivery-Netzwerke wie Cloudflare oder KeyCDN leiten den Traffic über ihre eigenen Server. Tritt ein Fehler auf CDN-Seite auf oder ist eine fehlerhafte Firewall-Regel konfiguriert, sehen Besucher einen 502, selbst wenn der Origin-Server voll funktionsfähig ist.

Um diese Hypothese zu testen, pausieren Sie das CDN in seinem Control Panel. Cloudflare: Gehen Sie zu Übersicht → Cloudflare pausieren. KeyCDN und ähnliche Dienste: Suchen Sie im Panel die Schaltfläche Deaktivieren oder Pausieren. Aktualisieren Sie nach der Deaktivierung Ihre Website. Verschwindet der Fehler, liegt das Problem auf CDN-Seite; kontaktieren Sie deren Support.

Während das CDN deaktiviert ist, läuft die Website direkt von Ihrem Hosting, sodass die Geschwindigkeit leicht sinken kann, die Verfügbarkeit aber wiederhergestellt wird. Wir haben gängige CDN-Dienste und deren Einrichtung in einem Artikel über kostenlose CDNs für WordPress verglichen.

Schritt 4. DNS-Einstellungen prüfen

Nach einem Hoster-Wechsel oder der Aktualisierung von NS-Einträgen verteilen sich die DNS-Informationen über einen Zeitraum von mehreren Stunden bis zu 48 Stunden im Netzwerk. Während dieser Zeit können einige Besucher auf dem alten Server landen, der nicht oder falsch antwortet.

Wenn Sie Ihre Website kürzlich umgezogen sind, warten Sie 24 Stunden; das ist in der Regel ausreichend. Leeren Sie zusätzlich Ihren lokalen DNS-Cache: Öffnen Sie unter Windows die Eingabeaufforderung und führen Sie ipconfig /flushdns aus; unter macOS führen Sie sudo dscacheutil -flushcache und sudo killall -HUP mDNSResponder aus. Aktualisieren Sie dann die Seite.

Schritt 5. Plugins per FTP deaktivieren

Die häufigste Ursache für einen 502 auf WordPress ist ein Plugin-Konflikt. Ein einziges problematisches Plugin kann einen fatalen PHP-Fehler verursachen, der die gesamte Website lahmlegt. Da das WordPress-Admin-Panel während eines 502 nicht zugänglich ist, müssen Sie Plugins über das Dateisystem deaktivieren.

Verbinden Sie sich per FTP mit dem Server (mit FileZilla, WinSCP) oder öffnen Sie den Dateimanager in cPanel. Navigieren Sie zum Wurzelverzeichnis der Website (normalerweise public_html):

Gehen Sie in wp-content und suchen Sie den Ordner plugins. Benennen Sie ihn um, zum Beispiel in plugins.old. Dies deaktiviert sofort alle Plugins auf einmal. Die Plugin-Daten werden beim Umbenennen des Ordners nicht gelöscht; die Einstellungen bleiben in der Datenbank erhalten:

Aktualisieren Sie die Website. Funktioniert sie, liegt das Problem bei einem der Plugins. Benennen Sie den Ordner zurück in plugins, gehen Sie ins Admin-Panel und aktivieren Sie die Plugins nacheinander, wobei Sie die Website nach jeder Aktivierung prüfen. Haben Sie den Übeltäter gefunden, löschen Sie ihn per FTP oder ersetzen Sie ihn durch eine Alternative.

Schritt 6. Aktives Theme prüfen

Wenn das Deaktivieren der Plugins nicht geholfen hat, ist der nächste Verdächtige das Theme. Fehlerhafter Code in functions.php oder ein Konflikt mit der PHP-Version kann ebenfalls einen fatalen Fehler und einen 502 verursachen.

Gehen Sie zurück zum Wurzelverzeichnis der Website → wp-content → themes. Suchen Sie den Ordner des aktiven Themes und benennen Sie ihn um (hängen Sie zum Beispiel .old an):

WordPress wechselt automatisch zum Standard-Theme (Twenty Twenty-Four, Twenty Twenty-Five oder ähnlich). Aktualisieren Sie die Website; ist der Fehler verschwunden, liegt das Problem am Theme. Kontaktieren Sie den Theme-Entwickler oder stellen Sie ein Backup wieder her. Benennen Sie den Ordner nach der Diagnose wieder in seinen ursprünglichen Namen zurück.

Ein detaillierter Algorithmus zum Überprüfen von Themes und Auffinden von widersprüchlichem Code ist im Leitfaden zur Fehlerbehebung bei WordPress-Theme-Problemen beschrieben.

Schritt 7. Die.htaccess-Datei zurücksetzen

Eine beschädigte .htaccess ist eine häufige, aber weniger offensichtliche Ursache für einen 502. Rewrite-Regeln, die von einem Caching-Plugin oder Sicherheits-Plugin hinzugefügt wurden, können miteinander in Konflikt geraten. Ein einziger Syntaxfehler in dieser Datei, und der Server liefert bei allen Anfragen einen 502.

Verbinden Sie sich per FTP und suchen Sie die .htaccess-Datei im Wurzelverzeichnis der Website. Laden Sie eine Sicherungskopie auf Ihren Computer herunter und löschen Sie dann die Datei vom Server. Gehen Sie ins WordPress-Admin-Panel, navigieren Sie zu Einstellungen → Permalinks und klicken Sie auf „Änderungen speichern" (ohne etwas zu ändern). WordPress erstellt eine neue .htaccess mit einem sauberen Regelsatz.

Wenn der Fehler unmittelbar nach der Installation eines Caching-Plugins (WP Rocket, W3 Total Cache, LiteSpeed Cache) auftrat, prüfen Sie in der .htaccess den Abschnitt mit den Regeln dieses Plugins; er ist normalerweise in Kommentare wie # BEGIN W3TC / # END W3TC eingefasst. Löschen Sie diesen Block, speichern Sie die Datei und aktualisieren Sie die Website.

Schritt 8. Kontaktieren Sie Ihren Hosting-Provider

Wenn keiner der vorherigen Schritte geholfen hat, liegt das Problem höchstwahrscheinlich auf der Serverseite. Kontaktieren Sie den technischen Support Ihres Hosters und nennen Sie die Domain, den Zeitpunkt des Auftretens des Fehlers und welche Schritte Sie bereits unternommen haben. Je mehr Details Sie liefern, desto schneller finden die Techniker die Ursache.

Bitten Sie sie, die PHP- und Webserver-Fehlerprotokolle für den Zeitraum zu prüfen, in dem der 502 auftrat. Die Protokolle zeigen fast immer genau, welches Skript oder Modul den Ausfall verursacht. Bei günstigen Shared-Hosting-Tarifen kann die Ursache schlicht Ressourcenmangel sein: Eine Website auf dem Server verbraucht den gesamten Arbeitsspeicher, und die übrigen erhalten einen 502. In diesem Fall ist es sinnvoll, über einen Umzug auf einen VPS oder Cloud-Hosting mit garantierten Ressourcen nachzudenken.

Video-Anleitung

Sehen Sie sich eine visuelle Schritt-für-Schritt-Anleitung zur Diagnose und Behebung des 502-Fehlers vom ersten bis zum letzten Schritt in diesem Video an:

⁉️🤔 Häufig gestellte Fragen

Kann sich ein 502-Fehler von selbst beheben?

Ja, wenn die Ursache eine kurze Überlastung des Hosting-Servers ist. Provider überwachen die Last und starten problematische Prozesse innerhalb von ein bis fünf Minuten automatisch neu. Aktualisieren Sie die Seite nach ein paar Minuten; in der Hälfte der Fälle verschwindet der Fehler ohne Ihr Zutun.

Wie unterscheide ich einen 502 von anderen Serverfehlern?

Ein 502 Bad Gateway ist ein Fehler auf der Ebene des Proxy-Servers (Nginx/Apache), nicht der Anwendung selbst. Ein 500 Internal Server Error weist auf ein Problem direkt im PHP-Code oder in der Konfiguration hin. Ein 503 Service Unavailable bedeutet, dass der Server vorübergehend keine Anfragen annimmt, normalerweise bei geplanten Wartungsarbeiten. Ein 504 Gateway Timeout bedeutet, dass der Server innerhalb der vorgesehenen Zeit keine Antwort vom Upstream-Server erhalten hat. Für den Anwender liegt der Unterschied in der Diagnose: Ein 500 wird meist durch Code-Änderungen behoben, ein 502 durch die Wiederherstellung der Kommunikation zwischen Servern.

Muss ich die Website bei einem 502 aus einem Backup wiederherstellen?

Ein Backup ist das letzte Mittel, nicht der erste Schritt. Bevor Sie ein Backup einspielen, führen Sie die Schritte 5, 6 und 7 dieser Anleitung aus: Deaktivieren Sie Plugins, prüfen Sie das Theme, setzen Sie .htaccess zurück. In den allermeisten Fällen wird ein 502 ohne Wiederherstellung aus einem Backup behoben. Spielen Sie ein Backup nur dann ein, wenn der Fehler unmittelbar nach der Aktualisierung von WordPress, Plugins oder eines Themes auftrat und ein Rollback der Änderungen per FTP nicht möglich ist.

Kann ich 502-Fehlern in Zukunft vorbeugen?

Teilweise ja. Nutzen Sie qualitativ hochwertiges Hosting mit ausreichend PHP-Arbeitsspeicher (empfohlenes Minimum sind 256 MB). Richten Sie ein Uptime-Monitoring für Ihre Website über UptimeRobot oder einen ähnlichen Dienst ein; Sie erfahren von einem Problem, bevor Besucher es melden. Erstellen Sie vor der Installation oder Aktualisierung von Plugins ein kurzes Backup. Und halten Sie den FTP-Zugang griffbereit: Wenn das Admin-Panel nicht erreichbar ist, ist das der einzige Weg, um problematischen Code schnell zu deaktivieren.

Was tun, wenn nichts geholfen hat?

Die acht oben genannten Schritte decken nahezu alle Szenarien für einen 502 Bad Gateway auf WordPress ab. Wenn Sie Plugins, Theme, DNS und CDN geprüft, .htaccess zurückgesetzt haben und der Fehler bestehen bleibt, liegt das Problem tiefer, und Sie kommen ohne die Techniker des Hosting-Providers nicht weiter.

Die richtige Reihenfolge spart Stunden: Schließen Sie zuerst lokale Ursachen aus (Cache, Browser, CDN), dann serverseitige (Plugins, Theme, .htaccess) und eskalieren Sie erst dann zum Provider. Speichern Sie diese Anleitung in Ihren Lesezeichen; ein 502 hat die Angewohnheit, im ungünstigsten Moment zurückzukehren, und der schnelle Zugriff auf die Checkliste erspart Ihnen viel Stress.