Zuletzt aktualisiert: 6. Oktober 2026
Quick Answer: Der WordPress Fehler 502 Bad Gateway entsteht fast immer zwischen dem Reverse Proxy (Nginx, Apache, Cloudflare) und dem PHP-FPM-Backend, nicht im WordPress-Core selbst. Der Proxy erhält keine gültige Antwort vom Upstream-Server und gibt den 502 an den Browser weiter. Die Lösung folgt einem klaren Diagnosepfad: zuerst Logs prüfen, dann PHP-FPM-Status kontrollieren, danach Proxy-Konfiguration und Ressourcen prüfen.
Key Takeaways
- Ein 502-Fehler ist ein Gateway-Problem, kein WordPress-Problem, WordPress selbst läuft oft gar nicht erst an.
- Die häufigsten Ursachen: PHP-FPM ist abgestürzt, der Socket-Pfad stimmt nicht, oder der Pool hat keine freien Worker mehr.
- Cloudflare und andere CDNs können einen 502 selbst erzeugen, wenn der Origin-Server nicht antwortet.
- Das PHP-Memory-Limit und überlastete Plugins sind bei WordPress-spezifischen 502-Fehlern die Hauptverdächtigen.
- Der Unterschied zum 503: Ein 502 bedeutet „falsche Antwort vom Upstream“, ein 503 bedeutet „kein Dienst verfügbar“.
- Intermittierende 502-Fehler bei hohem Traffic deuten fast immer auf zu wenige PHP-FPM-Worker hin.
- Nach einem WordPress-Update oder einer Plugin-Installation lohnt sich der sofortige Blick ins Error-Log.
- Eine Notfalllösung in unter 5 Minuten: PHP-FPM neu starten und Plugins per WP-CLI deaktivieren.
Was ist ein 502 Bad Gateway Fehler und warum tritt er bei WordPress auf?
Ein 502 Bad Gateway bedeutet: Der Webserver (der Proxy) hat eine Anfrage an einen anderen Server weitergeleitet, aber eine ungültige oder gar keine Antwort zurückbekommen [8]. Bei WordPress läuft das so ab: Der Browser fragt den Webserver (meist Nginx oder Apache), der reicht die PHP-Verarbeitung an PHP-FPM weiter, und genau diese Verbindung bricht.
WordPress selbst ist dabei oft nicht das Problem. Der CMS-Code wird gar nicht erst ausgeführt, weil PHP-FPM nicht antwortet. Das macht die Diagnose etwas trickreich, weil der WordPress-Debug-Modus allein nicht hilft.
Typische Auslöser auf einen Blick:
- PHP-FPM-Prozess ist abgestürzt oder wurde nicht gestartet
- Der Socket-Pfad in der Nginx-Konfiguration stimmt nicht mit dem tatsächlichen Socket überein
- PHP-FPM hat keine freien Worker mehr (Pool erschöpft)
- Ein Plugin verbraucht zu viel Speicher und bringt PHP zum Absturz
- Cloudflare oder ein anderer Proxy kann den Origin-Server nicht erreichen [1]
Merksatz: Der 502 ist immer ein Kommunikationsproblem zwischen zwei Servern, nie ein Fehler im Browser oder im WordPress-Theme.
PHP-FPM Diagnose: Dienststatus, Socket und Pool systematisch prüfen
PHP-FPM ist in den meisten 502-Fällen der direkte Verursacher. Der erste Schritt ist immer der Dienststatus [3][4].
Schritt 1, Dienststatus prüfen:
<code class="language-bash">systemctl status php8.3-fpm
</code>Wenn der Dienst inaktiv oder im Fehlerzustand ist, einfach neu starten:
<code class="language-bash">systemctl restart php8.3-fpm
</code>Schritt 2, Socket-Pfad kontrollieren:
Der häufigste Konfigurationsfehler: Nginx sucht den Socket an /var/run/php/php8.3-fpm.sock, aber PHP-FPM legt ihn woanders ab [4]. Den tatsächlichen Pfad findet man in der Pool-Konfiguration:
<code class="language-bash">cat /etc/php/8.3/fpm/pool.d/www.conf | grep "listen ="
</code>Nginx-Konfiguration und Pool-Konfiguration müssen exakt übereinstimmen. Außerdem muss der Nginx-Worker-User Lesezugriff auf den Socket haben.
Schritt 3, Pool-Parameter anpassen:
Wenn PHP-FPM läuft, aber trotzdem 502-Fehler auftreten, ist oft der Pool erschöpft [5][10]. Relevante Parameter in www.conf:
| Parameter | Bedeutung | Empfehlung |
|---|---|---|
pm.max_children |
Maximale Worker-Prozesse | RAM ÷ 30-50 MB pro Worker |
pm.max_requests |
Requests pro Worker vor Neustart | 500-1000 |
request_terminate_timeout |
Maximale Laufzeit pro Request | 60-120s |
Für eine tiefere Analyse der Serverprotokolle lohnt sich auch ein Blick in unsere WordPress Fehler 500 Diagnose-Checkliste mit Debug-Logs und Server-Logs.
WordPress 502 Fehler Nginx Proxy Settings überprüfen
Nginx-Fehlkonfigurationen sind nach PHP-FPM-Abstürzen die zweithäufigste Ursache für 502-Fehler bei WordPress [4][9]. Die kritischen Stellen in der Nginx-Konfiguration:
fastcgi_pass: Muss exakt auf den richtigen Socket oder Port zeigen.
<code class="language-nginx">location ~ .php$ {
fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
fastcgi_read_timeout 120;
fastcgi_connect_timeout 60;
}
</code>Timeout-Werte: Zu kurze Timeouts führen zu 502-Fehlern bei langsamen PHP-Prozessen [4]. fastcgi_read_timeout sollte mindestens 60 Sekunden betragen, bei WooCommerce-Shops eher 120 Sekunden.
Apache + mod_proxy: Wer Apache als Reverse Proxy vor PHP-FPM betreibt, prüft die entsprechenden Werte in der VirtualHost-Konfiguration:
<code class="language-apache">ProxyTimeout 120
ProxyPassMatch ^/(.*.php(/.*)?)$ fcgi://127.0.0.1:9000/var/www/html/$1
</code>
Häufiger Fehler: Nach einem PHP-Versionsupdate (z.B. von PHP 8.2 auf 8.3) ändert sich der Socket-Pfad automatisch. Nginx zeigt dann weiterhin auf den alten Pfad, klassischer 502. Mehr dazu im Artikel WordPress nach PHP-Versionswechsel kaputt: Typische Fehler beim Umstieg.
WordPress 502 Fehler nach Plugin-Installation oder Update beheben
Ein 502-Fehler tritt nach einer Plugin-Installation oder einem WordPress-Core-Update auf, weil das neue Plugin (oder der aktualisierte Code) PHP zum Absturz bringt, bevor eine Antwort zurückgesendet wird [3][6]. Das Ergebnis: PHP-FPM beendet den Prozess, Nginx bekommt keine Antwort, 502.
Schnelle Diagnose per WP-CLI:
<code class="language-bash">wp plugin deactivate --all
</code>Danach Plugins einzeln reaktivieren, bis der Fehler wieder auftritt. Ohne WP-CLI-Zugriff das Plugin-Verzeichnis umbenennen:
<code class="language-bash">mv wp-content/plugins wp-content/plugins_backup
</code>Wenn die Seite danach läuft, Verzeichnis zurückbenennen und Plugins einzeln testen.
Nach einem Core-Update: Hier lohnt sich ein Blick auf Theme-Kompatibilität und veraltete Plugins. Unser Artikel WordPress 6.9.4 Fehler 500 nach Core-Update: Kompatibilitätsprobleme mit Plugins und Themes schnell beheben erklärt das detailliert.
Für allgemeine Plugin-Konflikte gibt es außerdem unsere Anleitung zum HTTP 500 Fehler durch Plugin-Konflikt in WordPress finden.
WordPress 502 Fehler Memory Limit PHP erhöhen
Ein zu niedriges PHP-Memory-Limit ist ein unterschätzter 502-Auslöser. Wenn PHP während der Verarbeitung den Speicher überschreitet, bricht der Prozess ab, und PHP-FPM liefert keine gültige Antwort an Nginx [1][3].
Memory-Limit erhöhen in wp-config.php:
<code class="language-php">define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');
</code>Alternativ in der php.ini oder .htaccess:
<code class="language-ini">memory_limit = 256M
</code>Wann reicht das nicht? Wenn ein Plugin oder Theme grundsätzlich zu viel Speicher verbraucht, hilft ein höheres Limit nur kurzfristig. Dann ist der Verursacher zu identifizieren und zu ersetzen. Unsere ausführliche Anleitung zum PHP Memory Limit in WordPress erhöhen zeigt alle Wege.
Cloudflare WordPress 502 Fehler: Origin Unreachable lösen
Cloudflare erzeugt einen eigenen 502-Fehler mit dem Hinweis „Error 502 Bad Gateway“ oder „Error 521 Web Server Is Down“, wenn der Origin-Server (der eigentliche Webserver) nicht erreichbar ist [8]. Das ist ein anderer Fehlertyp als ein interner Nginx-502.
Unterscheidung: Cloudflare zeigt bei eigenen Fehlern seine Markenseite mit dem Cloudflare-Logo. Ein Nginx-502 ohne Cloudflare-Branding kommt direkt vom Webserver.
Häufige Ursachen bei Cloudflare:
- Der Origin-Server ist ausgefallen oder überlastet
- Cloudflare ist auf „Full (strict)“ SSL eingestellt, aber das Origin-Zertifikat ist abgelaufen oder fehlt
- Firewall-Regeln blockieren Cloudflare-IPs auf dem Origin-Server
- Der Hostname im DNS zeigt auf die falsche IP
Schnelltest: Cloudflare temporär auf „Development Mode“ oder „Pause Cloudflare on Site“ setzen und direkt über die Server-IP aufrufen. Wenn die Seite dann läuft, liegt das Problem bei Cloudflare oder der Verbindung zwischen Cloudflare und dem Origin.
Unterschied zwischen 502 Bad Gateway und 503 Service Unavailable
Der 502 und der 503 werden oft verwechselt, haben aber unterschiedliche Ursachen und erfordern unterschiedliche Lösungen.
| Fehler | Bedeutung | Typische Ursache |
|---|---|---|
| 502 Bad Gateway | Proxy erhält ungültige Antwort | PHP-FPM abgestürzt, falsche Konfiguration |
| 503 Service Unavailable | Dienst vorübergehend nicht verfügbar | Wartungsmodus, Überlastung, Rate Limiting |
Ein 502 bedeutet: Der Upstream-Server antwortet, aber falsch (oder gar nicht). Ein 503 bedeutet: Der Server weiß, dass er gerade nicht helfen kann, und sagt das explizit.
Praktische Konsequenz: Bei einem 502 zuerst PHP-FPM und Proxy-Konfiguration prüfen. Bei einem 503 zuerst den WordPress-Wartungsmodus und Server-Ressourcen prüfen. Mehr zum 503 erklärt unser Artikel WordPress Fehler 503 Service Unavailable: Wartungsmodus, Serverlimits und Plugin-Probleme sicher beheben.
WordPress Error Log: Wo finde ich 502 Fehler Logs?
Der 502-Fehler selbst erscheint nicht im WordPress-Debug-Log, weil WordPress nie ausgeführt wird. Die relevanten Logs liegen auf Serverebene [3][4].
Nginx Error Log:
<code class="language-bash">tail -f /var/log/nginx/error.log
</code>Typische Meldung: connect() to unix:/var/run/php/php8.3-fpm.sock failed (11: Resource temporarily unavailable)
PHP-FPM Log:
<code class="language-bash">tail -f /var/log/php8.3-fpm.log
</code>Hier erscheinen Worker-Erschöpfung und Timeout-Meldungen.
Apache Error Log:
<code class="language-bash">tail -f /var/log/apache2/error.log
</code>Bei Managed Hosting: Viele Hoster (Raidboxes, Kinsta, WP Engine) bieten Log-Zugriff direkt im Dashboard. Bei Shared Hosting gibt es oft nur begrenzten Log-Zugriff, dann hilft die Anfrage beim Support mit dem genauen Zeitstempel des Fehlers.
502 Fehler WordPress bei hohem Traffic und intermittierend auftretende Fehler
Wenn der 502-Fehler nur manchmal auftritt, besonders bei Traffic-Spitzen, ist der PHP-FPM-Pool das wahrscheinlichste Problem [5][10]. Alle Worker sind belegt, neue Anfragen werden abgewiesen, Nginx bekommt keine Antwort.
Diagnose: Im PHP-FPM-Status-Endpoint (wenn aktiviert) oder im Log nach Meldungen wie server reached pm.max_children suchen.
Lösungen:
pm.max_childrenerhöhen (aber RAM-Limit beachten: jeder Worker braucht ca. 30-60 MB)pmvonstaticaufdynamicoderondemandumstellen- Caching aktivieren (z.B. WP Super Cache, W3 Total Cache), damit weniger PHP-Prozesse nötig sind
- Slow Queries in der Datenbank optimieren, die Worker lange blockieren
Bei dauerhaft hohem Traffic ist Caching die wichtigste Maßnahme. Unser Artikel zur WordPress Seite langsam laden: Performance-Probleme systematisch diagnostizieren zeigt, wie man das angeht.
502 Bad Gateway WordPress: Schnelle Notfall-Lösung
Wenn die Website jetzt sofort wieder laufen muss, hilft diese Checkliste in unter 10 Minuten [1][3]:
- PHP-FPM neu starten:
systemctl restart php8.3-fpm - Webserver neu starten:
systemctl restart nginxodersystemctl restart apache2 - Alle Plugins deaktivieren: WP-CLI (
wp plugin deactivate --all) oder Plugin-Ordner umbenennen - Memory-Limit erhöhen:
define('WP_MEMORY_LIMIT', '256M');inwp-config.php - Error-Log prüfen: Nginx- und PHP-FPM-Log auf konkrete Fehlermeldungen durchsuchen
- Hosting-Support kontaktieren: Bei Managed Hosting oft die schnellste Lösung
Wenn keiner dieser Schritte hilft oder der Fehler immer wieder kommt, liegt meist ein tieferes Konfigurationsproblem vor. In diesem Fall lohnt sich professionelle Hilfe, Kay Jaeger und das WP-Repair-Team analysieren den Fehler kostenlos und erstellen ein unverbindliches Angebot. Einfach über wp-repair.de anfragen oder direkt anrufen: 0 23 32 – 91 44 44.
Für weitere Notfallsituationen gibt es auch unsere WordPress Soforthilfe bei Ausfall.
502 Bad Gateway WordPress Hosting Provider: Wessen Schuld ist es?
Die Frage, ob der Hoster oder die eigene Konfiguration schuld ist, lässt sich mit einem einfachen Test klären.
Hoster ist verantwortlich, wenn:
- Der Fehler ohne eigene Änderungen auftritt
- Der Hoster-Support bestätigt, dass Server-Ressourcen erschöpft sind
- Das Problem auf allen Websites des gleichen Hosting-Pakets auftritt
- Cloudflare einen „Error 521″ zeigt (Origin-Server nicht erreichbar)
Eigene Konfiguration ist verantwortlich, wenn:
- Der Fehler nach einem Update, Plugin-Install oder Konfigurationsänderung begann
- Nur eine Website betroffen ist
- Die Logs einen konkreten Fehler in der Nginx- oder PHP-FPM-Konfiguration zeigen
Bei Shared Hosting hat man oft keinen Zugriff auf PHP-FPM-Einstellungen. Hier ist der Hoster-Support der richtige Ansprechpartner. Bei VPS und dedizierten Servern liegt die Verantwortung meistens beim Betreiber.
PHP-FPM Pool Size erhöhen gegen 502 Fehler
Die Pool-Größe ist der häufigste Hebel gegen wiederkehrende 502-Fehler bei WordPress unter Last [5][10]. Die Konfigurationsdatei liegt typischerweise unter /etc/php/8.3/fpm/pool.d/www.conf.
Empfohlene Konfiguration für einen Server mit 2 GB RAM:
<code class="language-ini">pm = dynamic
pm.max_children = 20
pm.start_servers = 5
pm.min_spare_servers = 3
pm.max_spare_servers = 8
pm.max_requests = 500
request_terminate_timeout = 120s
</code>Faustregel: Verfügbarer RAM (in MB) ÷ durchschnittlicher Speicherverbrauch pro PHP-Prozess (meist 30-60 MB) = maximale pm.max_children.
Nach Änderungen immer PHP-FPM neu starten und das Log beobachten.
Fazit und nächste Schritte
Den WordPress Fehler 502 Bad Gateway beheben ist kein Hexenwerk, wenn man den richtigen Diagnosepfad kennt: Gateway-Ebene zuerst, dann PHP-FPM, dann WordPress-spezifische Ursachen. Die meisten Fälle lassen sich mit einem Neustart von PHP-FPM, einer korrekten Socket-Konfiguration und einem angepassten Memory-Limit lösen.
Konkrete nächste Schritte:
- Nginx- und PHP-FPM-Log auf die genaue Fehlermeldung prüfen
- PHP-FPM-Dienststatus kontrollieren und ggf. neu starten
- Socket-Pfad in Nginx-Konfiguration und PHP-FPM-Pool abgleichen
- Memory-Limit in
wp-config.phpauf mindestens 256 MB setzen - Plugins einzeln deaktivieren, um einen Verursacher auszuschließen
- Bei Cloudflare: Origin-Erreichbarkeit direkt testen
Wenn der Fehler trotz aller Maßnahmen bestehen bleibt oder immer wieder auftaucht, steckt oft ein tieferes Problem dahinter, das professionelle Diagnose braucht. Das WP-Repair-Team um Kay Jaeger löst solche Fälle täglich, mit über 20 Jahren Erfahrung und einer Erfolgsquote von 98,2 %. Die Ersteinschätzung ist komplett kostenlos und unverbindlich.
FAQ
Was bedeutet 502 Bad Gateway bei WordPress genau? Der Webserver (Proxy) hat eine Anfrage an PHP-FPM weitergeleitet, aber keine gültige Antwort erhalten. WordPress selbst wird dabei oft gar nicht ausgeführt.
Wie lange dauert es, einen PHP-FPM Timeout zu beheben? Ein einfacher Neustart von PHP-FPM dauert unter einer Minute. Die vollständige Diagnose und Konfigurationsanpassung dauert je nach Ursache 15 bis 60 Minuten.
Kann ein Plugin einen 502 Fehler verursachen? Ja. Wenn ein Plugin PHP zum Absturz bringt oder zu viel Speicher verbraucht, beendet PHP-FPM den Prozess, und Nginx bekommt keine Antwort [3][6].
Was ist der Unterschied zwischen 502 und 504? Ein 502 bedeutet „ungültige Antwort vom Upstream“. Ein 504 bedeutet „Timeout, keine Antwort innerhalb der erlaubten Zeit“. Beide können durch PHP-FPM-Probleme entstehen, aber die Ursachen unterscheiden sich.
Hilft ein WordPress-Backup gegen den 502 Fehler? Ein Backup hilft, wenn der Fehler durch eine Änderung (Update, Plugin) verursacht wurde. Es behebt keine Server-Konfigurationsprobleme.
Wie finde ich heraus, ob Cloudflare den 502 verursacht? Cloudflare temporär pausieren und die Website direkt über die Server-IP aufrufen. Wenn sie dann läuft, ist Cloudflare oder die Verbindung zwischen Cloudflare und dem Origin das Problem.
Kann ich den 502 Fehler selbst beheben, ohne Server-Zugriff?
Eingeschränkt. Ohne SSH-Zugriff kann man Plugins deaktivieren und das Memory-Limit in wp-config.php erhöhen. PHP-FPM und Nginx-Konfiguration erfordern Server-Zugriff oder Hoster-Support.
Warum tritt der 502 Fehler nur manchmal auf? Intermittierende 502-Fehler bei Traffic-Spitzen deuten fast immer auf einen erschöpften PHP-FPM-Pool hin. Mehr Worker oder besseres Caching lösen das Problem [5].
Muss ich WordPress neu installieren, um den 502 zu beheben? Nein. Eine Neuinstallation ist bei einem 502-Fehler fast nie nötig. Der Fehler liegt auf Server-Ebene, nicht im WordPress-Code.
Was kostet professionelle Hilfe bei einem 502 Fehler? Bei WP-Repair ist die Ersteinschätzung kostenlos. Die Behebung erfolgt nach einem unverbindlichen Festpreisangebot. Falls der Fehler nicht behoben werden kann, fällt nur eine Aufwandspauschale von 49 EUR an.
References
[1] WordPress 502 Bad Gateway Error How To Fix It – https://www.hostney.com/blog/how-to/wordpress-502-bad-gateway-error-how-to-fix-it [2] How To Fix 502 Error Php Fpm Socket Issues In Php Laravel Forge – https://laravel.com/blog/how-to-fix-502-error-php-fpm-socket-issues-in-php-laravel-forge [3] WordPress 502 Bad Gateway Error Troubleshoot Fix – https://gigapress.net/wordpress-502-bad-gateway-error-troubleshoot-fix/ [4] How To Fix Nginx 502 Bad Gateway – https://linuxcapable.com/how-to-fix-nginx-502-bad-gateway/ [5] Nginx 502 Bad Gateway Errors Php Fpm – https://www.datadoghq.com/blog/nginx-502-bad-gateway-errors-php-fpm/ [6] Erro 502 Bad Gateway – https://www.homehost.com.br/blog/internet/erro-502-bad-gateway/ [8] 502 Bad Gateway – https://pulsetic.com/errors/502-bad-gateway/ [9] Nginx Php Fpm 502 Bad Gateway – https://serverfault.com/questions/457911/nginx-php-fpm-502-bad-gateway [10] cloud.tencent – https://cloud.tencent.com/developer/article/1966434