Błąd 502 Bad Gateway w WordPress – przyczyny i naprawa krok po kroku

Komunikat „502 Bad Gateway" pojawia się nagle, bez ostrzeżenia — i potrafi skutecznie zablokować zarówno odwiedzających, jak i administratora strony. W odróżnieniu od wielu innych błędów WordPress, 502 ma swoje źródło nie w kodzie witryny, lecz w infrastrukturze serwera. To dobra wiadomość: oznacza, że Twoje treści, baza danych i konfiguracja są najprawdopodobniej nienaruszone.

Ten poradnik tłumaczy, czym dokładnie jest błąd 502, gdzie szukać jego przyczyny i jak go usunąć — krok po kroku, od najprostszych działań po bardziej zaawansowane.

Czym różni się błąd 502 od 503?

Oba kody oznaczają niedostępność strony, ale mają inne źródło. Kod 503 (Service Unavailable) informuje, że serwer jest przeciążony lub w trybie konserwacji, to problem z wydajnością. Kod 502 (Bad Gateway) oznacza natomiast, że jeden serwer (np. Nginx odgrywający rolę proxy lub CDN) wysłał żądanie do serwera nadrzędnego (np. PHP-FPM lub serwera Apache) i otrzymał nieprawidłową lub żadną odpowiedź.

Innymi słowy: przy 503 serwer wie, że jest przeciążony i sam odrzuca żądania. Przy 502 komunikacja między warstwami infrastruktury się zrywa, jedna warstwa czeka na odpowiedź od drugiej i w końcu się poddaje.

Najczęstsze przyczyny błędu 502 Bad Gateway w WordPress

Awaria lub przeciążenie PHP-FPM

Najczęstsze źródło błędu 502 w środowiskach z Nginx jako frontendem. PHP-FPM (FastCGI Process Manager) obsługuje wykonywanie skryptów PHP — jeśli jego procesy są przeciążone, zawieszone lub usługa uległa awarii, Nginx nie może uzyskać odpowiedzi i zwraca klientowi kod 502.

Objawem jest to, że strona zwraca 502 dla wszystkich podstron generowanych dynamicznie (strona główna, wpisy, panel WP Admin), ale pliki statyczne (obrazy, CSS, JS) wciąż mogą się wczytywać poprawnie.

Zbyt krótki timeout po stronie proxy

Gdy Nginx lub CDN (np. Cloudflare) czeka na odpowiedź PHP dłużej niż dozwolony czas (domyślnie często 60 sekund), przerywa połączenie i zwraca błąd 502. Przyczyną może być zapytanie do bazy danych, które trwa zbyt długo, lub wtyczka wykonująca ciężką operację (np. import danych, generowanie raportu, wysyłka masowej korespondencji).

Problem z CDN lub usługą proxy

Jeśli Twoja strona korzysta z CDN (Cloudflare, KeyCDN, BunnyCDN), błąd 502 może być generowany przez samą sieć dostarczania treści, niezależnie od stanu Twojego serwera. W takim przypadku strona działa poprawnie po wpisaniu adresu IP serwera bezpośrednio, ale zwraca 502 przez domenę przechodzącą przez CDN.

Błąd konfiguracji serwera po aktualizacji

Aktualizacje systemu operacyjnego, serwera Nginx/Apache lub PHP mogą zmienić domyślną ścieżkę do gniazda PHP-FPM albo numer wersji PHP używanej przez wirtualny host. Jeśli konfiguracja Nginx nadal wskazuje na starą ścieżkę (/run/php/php8.1-fpm.sock), a system używa już PHP 8.2, każde żądanie zakończy się błędem 502.

Niewystarczające zasoby serwera

Brak wolnej pamięci RAM wymusza zamykanie procesów PHP przez system operacyjny (mechanizm OOM Killer). Gdy PHP-FPM zostanie ubity przez OOM Killer, Nginx nie ma do kogo kierować żądań — i zwraca 502. Na hostingu WordPress w planie współdzielonym ten problem ujawnia się przy rosnącym ruchu lub podczas wykonywania wielu zadań równolegle.

Jak naprawić błąd 502 w WordPress — krok po kroku

Krok 1 — odczekaj i sprawdź ponownie

Zanim zaczniesz działać, upewnij się, że błąd nie jest tymczasowy. Odśwież stronę po 60–90 sekundach. Sprawdź też, czy błąd dotyczy tylko Twojej witryny. Serwisy takie jak downforeveryoneorjustme.com  pozwolą Ci potwierdzić, czy problem jest globalny, czy lokalny.

Krok 2 — sprawdź status CDN

Jeśli korzystasz z Cloudflare lub innego CDN, wejdź na stronę statusu usługi. Jeśli CDN raportuje incydent, wystarczy poczekać na jego rozwiązanie po stronie dostawcy. Możesz też tymczasowo wyłączyć proxy CDN (w Cloudflare: zmień rekord DNS z trybu „Proxied" na „DNS only"), by sprawdzić, czy strona działa bez warstwy pośredniej.

Krok 3 — dezaktywuj wtyczki WordPress

Jeśli błąd pojawił się po instalacji lub aktualizacji wtyczki, to ona może być przyczyną. Połącz się z serwerem przez FTP lub menedżer plików i przejdź do katalogu wp-content/plugins/. Zmień nazwę folderu plugins na plugins_backup, WordPress wyłączy wszystkie wtyczki. Sprawdź, czy strona działa. Jeśli tak, reaktywuj wtyczki pojedynczo, by znaleźć tę problematyczną.

Krok 4 — sprawdź logi serwera i PHP

Logi to najszybszy sposób na potwierdzenie hipotezy. W panelu hostingowym poszukaj sekcji logów błędów. Kluczowe komunikaty wskazujące na problem z PHP-FPM to m.in.:

  • connect() to unix:/run/php/php8.2-fpm.sock failed (111: Connection refused) — PHP-FPM nie działa lub wskazana ścieżka gniazda jest błędna,
  • upstream timed out (110: Connection timed out) — PHP przetwarza żądanie zbyt długo,
  • no live upstreams while connecting to upstream — wszystkie procesy PHP są zajęte lub niedostępne.

Informacje z logów przekaż do supportu hostingu — znacznie przyspieszą diagnozę.

Krok 5 — przywróć poprzednią wersję z kopii zapasowej

Jeśli błąd pojawił się bezpośrednio po aktualizacji rdzenia WordPress, motywu lub wtyczki i żadne z powyższych kroków nie pomogło, rozważ przywrócenie kopii zapasowej sprzed zmiany. Większość dostawców hostingu oferuje możliwość przywrócenia stanu z poprzedniego dnia lub tygodnia. Sprawdź, czy ta opcja jest dostępna w Twoim panelu.

Krok 6 — skontaktuj się z supportem hostingu

Jeśli logi wskazują na problem z konfiguracją PHP-FPM, brakiem zasobów RAM lub błędną konfiguracją proxy, to zadanie dla techników hostingu. Przygotuj: dokładny czas pierwszego wystąpienia błędu, adres URL strony, komunikaty z logów i opis działań, które podjąłeś. Dobrze opisany ticket jest rozwiązywany znacznie szybciej.

Jak zapobiegać błędowi 502 w przyszłości?

Wybór odpowiedniego hostingu

Błąd 502 wywołany brakiem zasobów to wyraźny sygnał, że obecny plan przestał być wystarczający. Hosting WordPress zoptymalizowany pod kątem PHP i baz danych MySQL zazwyczaj lepiej radzi sobie z dynamicznymi stronami niż hosting ogólnego przeznaczenia. Jeśli strona generuje duży ruch lub uruchamia wiele procesów równolegle, migracja na serwer VPS z dedykowanymi zasobami jest najtrwalszym rozwiązaniem, eliminuje zależność od innych użytkowników współdzielonych zasobów.

Regularne kopie zapasowe

Choć błąd 502 rzadko wiąże się z utratą danych, posiadanie aktualnych kopii zapasowych daje swobodę działania podczas diagnostyki. Wiesz, że możesz cofnąć każdą zmianę — co znacząco obniża stres i przyspiesza podejmowanie decyzji.

Certyfikat SSL i bezpieczna konfiguracja

Nieprawidłowa konfiguracja SSL (np. certyfikat wygasł lub nie obejmuje wszystkich domen) może powodować błędy na styku CDN–serwer, które niekiedy manifestują się jako 502. Upewnij się, że certyfikat SSL dla WordPress jest aktualny.

Optymalizacja zapytań i wtyczek

Długo trwające zapytania do bazy danych i źle zoptymalizowane wtyczki to prosta droga do timeoutów PHP, które kończą się błędem 502. Regularnie audytuj listę aktywnych wtyczek, sprawdzaj czas odpowiedzi strony i usuwaj te, które generują nieproporcjonalnie duże obciążenie.

Bezpieczeństwo i ochrona przed przeciążeniem

Ataki brute-force na panel logowania i boty skanujące luki w zabezpieczeniach potrafią w krótkim czasie wyczerpać zasoby PHP i wywołać błąd 502. Wdrożenie odpowiednich reguł ochronnych na poziomie bezpiecznego hostingu, takich jak limit prób logowania, blokada złośliwych botów na poziomie serwera lub zapora aplikacyjna (WAF), skutecznie redukuje to ryzyko.

Podsumowanie

Błąd 502 Bad Gateway w WordPress jest nieprzyjemny, ale jego diagnoza jest możliwa do przeprowadzenia krok po kroku nawet bez głębokiej wiedzy serwerowej. Zacznij od sprawdzenia statusu CDN i dezaktywacji wtyczek, a następnie przejdź do analizy logów. W większości przypadków problem tkwi w PHP-FPM lub w chwilowym przeciążeniu serwera i daje się usunąć w ciągu kilkudziesięciu minut.

Na dłuższą metę kluczowe jest dopasowanie infrastruktury do skali projektu. Aktywne kopie zapasowe, odpowiednio dobrany plan hostingu WordPress lub serwer VPS oraz dbałość o bezpieczeństwo hostingu to fundament, który sprawia, że błąd 502 staje się rzadkością, a nie stałym elementem życia webmastera.