Jak naprawić błąd 502 Bad Gateway? Kompletny poradnik 2026 | WebMajka

Błąd 502 Bad Gateway — co oznacza

502 Bad Gateway to kod statusu HTTP oznaczający problem z komunikacją między serwerami. Mówiąc prosto: serwer pośredniczący (proxy, gateway, CDN) nie mógł otrzymać prawidłowej odpowiedzi z serwera docelowego. W praktyce błąd 502 Bad Gateway pojawia się przy otwieraniu strony zamiast jej treści — użytkownik widzi komunikat w przeglądarce (Chrome wyświetla charakterystyczną stronę błędu). To jeden z najczęstszych problemów serwerowych — dotyka zarówno małe strony z WordPressem, jak i wielkich gigantów typu Google, Facebook, Twitter (widzieliśmy 502 u wszystkich). Dobra wiadomość: w większości przypadków błąd jest naprawialny w kilka minut. Zła wiadomość: przyczyn może być tuzin, więc trzeba systematycznie diagnozować.

Jak technicznie działa błąd serwera 502

Typowa architektura nowoczesnej strony:

1. Użytkownik → przeglądarka

2. CDN (Cloudflare, Bunny) — przechowuje cache, przyspiesza

3. Load balancer — rozdziela ruch między serwery

4. Reverse proxy (Nginx, Apache) — przed serwerem aplikacji

5. Serwer aplikacji (PHP-FPM, Node.js) — generuje stronę

6. Baza danych (MySQL, PostgreSQL)

Błąd 502 powstaje, gdy jeden z elementów pośrednich (2-4) próbuje skontaktować się z niższym poziomem i otrzymuje: brak odpowiedzi, timeout, błędną odpowiedź, zresetowane połączenie. Najczęściej problem jest między reverse proxy a serwerem aplikacji — np. PHP-FPM nie odpowiada, albo Node.js się wywalił.

502 bad gateway przyczyny — 10 najczęstszych

Praktyczna lista przyczyn błędu 502 w kolejności częstotliwości:

1. Przeciążenie serwera — za dużo jednoczesnych żądań

2. PHP-FPM się zawiesił — crashed worker

3. Timeout PHP — skrypt działa dłużej niż max_execution_time

4. Brak pamięci PHP — przekroczenie memory_limit

5. Problem z CDN (Cloudflare) — tymczasowa awaria

6. Błędny kod aplikacji — nieobsłużony fatal error

7. Problemy z MySQL — baza nie odpowiada, max connections

8. Restart serwera — updaty, konserwacja

9. DDoS attack — atak wypełniający zasoby

10. Błędna konfiguracja Nginx/Apache

Każda z tych przyczyn ma inne rozwiązanie. Diagnoza zaczyna się od sprawdzenia logów serwera i statusu hostingu.

502 bad gateway jak naprawić — od strony użytkownika

Jeśli widzisz 502 jako zwykły użytkownik (nie webmaster), wypróbuj:

1. Odśwież stronę (F5 lub Ctrl+R) — w 40% przypadków to wystarcza

2. Poczekaj 5 minut i spróbuj ponownie — często to chwilowy problem

3. Wyczyść cache przeglądarki (Ctrl+Shift+Del w Chrome) — usuń cache z ostatniej godziny

4. Wypróbuj inną przeglądarkę albo tryb incognito

5. Sprawdź czy strona działa dla innych — downforeveryoneorjustme.com albo downdetector.pl

6. Zmień DNS — Cloudflare 1.1.1.1 lub Google 8.8.8.8

7. Restart routera — rzadko pomaga przy 502, ale nie szkodzi

8. Poczekaj — webmaster prawdopodobnie już rozwiązuje problem

Jeśli po godzinie strona nadal nie działa — skontaktuj się z webmasterem przez inne kanały (mail, Facebook).

Naprawa błędu 502 po stronie webmastera — WordPress

Jeśli jesteś właścicielem strony i twoja strona WordPress pokazuje 502:

Krok 1 — Sprawdź hosting

• Zaloguj się do panelu hostingu (cPanel, DirectAdmin, Plesk)
• Sprawdź error log (wp-content/debug.log, php_errorlog, error_log)
• Kluczowe linie: PHP Fatal error, allowed memory size exhausted, max_execution_time exceeded

Krok 2 — Zwiększ limity PHP

W pliku wp-config.php dodaj:

define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');
ini_set('max_execution_time', 300);

Krok 3 — Dezaktywuj wtyczki

• Przez FTP zmień nazwę folderu /wp-content/plugins/ na /wp-content/plugins_off/
• Strona powinna znów działać
• Włączaj wtyczki jedną po drugiej, sprawdzając, która powoduje problem

Krok 4 — Zmień motyw na domyślny

• W panelu WP wybierz motyw typu Twenty Twenty-Four
• Jeśli pomaga — problem w twoim motywie

Krok 5 — Wyczyść cache

• Wtyczki cache (LiteSpeed, WP Rocket)
• Cache CDN (Cloudflare Purge)
• Browser cache użytkowników

Jeśli nic nie pomaga — skontaktuj się z supportem hostingu.

502 bad gateway chrome — specyfika Chrome

Chrome ma charakterystyczną stronę błędu 502:

This page isn't working
example.pl is currently unable to handle this request.
HTTP ERROR 502

Specyficznie dla Chrome:

• Problem z rozszerzeniami — dezaktywuj rozszerzenia (Ctrl+Shift+N tryb incognito testuje to)
• Konflikt z VPN — wyłącz VPN/Proxy
• Cache Chrome — czasami lokalny cache psuje połączenie
• Chrome flags — niekompatybilne eksperymenty
• DNS Chrome — w chrome://net-internals/#dns kliknij "Clear host cache"
• Network diagnostics — chrome://settings/network → "Network services"

Jeśli 502 występuje tylko w Chrome — problem po twojej stronie. Jeśli we wszystkich przeglądarkach — problem serwera.

503 vs 502 — łatwo pomylić

Często mylone kody błędów:

System poprawnej diagnostyki wymaga znajomości tych rozróżnień. Np. jeśli widzisz 503, często jest to celowy tryb konserwacji, nie awaria.

Naprawa 502 u supportu hostingu — co powiedzieć

Gdy piszesz do supportu hostingu, dostarcz maksimum informacji:

• Dokładny URL ze stroną problem
• Czas wystąpienia problemu (od kiedy nie działa)
• Screen błędu — pełny komunikat
• Lista ostatnich zmian — aktualizacje WP, wtyczek, motywu, nowe wgrania
• Error logi — kopia ostatnich wpisów
• Co już spróbowałeś — dezaktywacja wtyczek, itp.
• Testy: działa w mobile, działa w kolejnej przeglądarce?

Im więcej informacji podasz, tym szybciej support rozwiąże problem. Czasami wystarczy restart PHP-FPM na serwerze — operacja zajmuje support 30 sekund.

Prewencja — jak uniknąć błędu 502

Zabiegi prewencyjne zmniejszają szansę na 502:

• Dobry hosting — płatny, z polskim supportem i SLA
• Monitoring uptime — UptimeRobot (darmowe), Pingdom, StatusCake
• Optymalizacja WP — cache, zoptymalizowane obrazki, usunięte zbędne wtyczki
• Regularne aktualizacje — WP core, motyw, wtyczki
• Kopie zapasowe — UpdraftPlus, BackupBuddy (na wypadek poważnych awarii)
• CDN — Cloudflare free plan daje sporo ochrony
• Limity PHP — wystarczające memory_limit, max_execution_time
• Security plugin — Wordfence blokuje ataki
• Load testing — test obciążeniowy przed kampanią reklamową
• DNS monitoring — Cloudflare Health Checks

Prewencja to zawsze tańsza niż reakcja — regularne audyty strony zapobiegają 90% problemów.

Błędy 502 u gigantów — nawet Google bywa offline

Błędy 502 nie są rzadkością nawet u największych:

• Cloudflare Incident 2019 — 30 minut awarii przez błąd WAF, miliardy stron offline
• Fastly Incident 2021 — godzina awarii, strony Amazon, Reddit, GitHub, Twitch, NYT
• AWS Outage 2023 — 2 godziny problemów w regionie eu-west-1
• Twitter/X — regularne 502 po przejęciu przez Muska
• GitHub — co 2-3 miesiące 502 na kilka minut

Lekcja: awarie się zdarzają nawet największym. Chodzi o to, żeby były krótkie i szybko rozwiązywane. Dla twojej strony — monitoring i szybka reakcja są kluczem.

Cloudflare i 502 — częsta przyczyna

Jeśli używasz Cloudflare (darmowy CDN), błąd 502 może pochodzić z trzech źródeł:

1. Origin server (twój) jest offline — Cloudflare nie może go osiągnąć

2. Cloudflare ma problem — rzadko, ale się zdarza

3. Firewall Cloudflare blokuje legitne żądanie — rzadko

Diagnostyka: tymczasowo wyłącz Cloudflare (Development Mode lub Pause Cloudflare). Jeśli strona zadziała — problem w CF. Jeśli nie — w twoim serwerze. Pomaga też sprawdzenie Cloudflare Status (www.cloudflarestatus.com).

Podsumowanie — błąd 502 można pokonać

Błąd 502 Bad Gateway jest stresujący, ale w 90% przypadków naprawialny. Dla zwykłego użytkownika: odśwież, wyczyść cache, poczekaj 5 minut. Dla webmastera: sprawdź logi hostingu, dezaktywuj wtyczki, zwiększ limity PHP, skontaktuj się z supportem. Prewencja to: dobry hosting, monitoring uptime, regularne aktualizacje, backupy, Cloudflare. Jeśli błąd powtarza się regularnie — to sygnał do zmiany hostingu na lepszy. Błąd 502 raz na parę miesięcy to normalne, ale codziennie — nie. Przy profesjonalnym tworzeniu stron internetowych wdrażamy pełny monitoring uptime i cache — nasi klienci rzadko widzą 502, a gdy się pojawi — szybko go rozwiązujemy.