502 Bad Gateway — co oznacza, 10 przyczyn, jak naprawić i SEO impact [2026]

502 Bad Gateway to kod błędu HTTP, który oznacza jedno: serwer pośredniczący (proxy, brama, CDN) dostał nieprawidłową odpowiedź od serwera nadrzędnego. Nie ma znaczenia, czy korzystasz z Chrome czy Firefoxa. Problem jest po stronie infrastruktury serwerowej, nie po Twojej.

W tym przewodniku znajdziesz: oficjalną definicję z RFC 9110, różnice między 502 a 500/503/504, 10 konkretnych przyczyn na poziomie konfiguracji, jak Googlebot reaguje na powtarzające się błędy 502 (i kiedy strona wypada z indeksu), oraz specyfikę polskich hostingów (cyber_Folks, home.pl, OVH, nazwa.pl).

Jeśli zarządzasz stroną, przejdź od razu do sekcji o diagnostyce. Jeśli jesteś użytkownikiem, który po prostu chce zobaczyć stronę, wystarczy część dla użytkownika.

Czym dokładnie jest błąd 502 Bad Gateway?

Zgodnie z RFC 9110 (§15.6.3), kod 502 oznacza dokładnie tyle:

“A server was acting as a gateway or proxy and that it received an invalid response from the upstream server.”

Po polsku: serwer pełniący rolę bramy lub proxy odebrał nieprawidłową odpowiedź z serwera, na który przekazał Twoje żądanie.

W praktyce wygląda to tak. Wpisujesz adres w przeglądarce. Żądanie trafia najpierw do CDN-a (np. Cloudflare). CDN przekazuje je do serwera origin (np. Twojego VPS w OVH). Origin powinien odpowiedzieć HTML-em. Zamiast tego, milczy, zwraca śmieci, albo zamyka połączenie w połowie. CDN, nie wiedząc co z tym zrobić, zwraca Ci 502.

502 to nie oznacza, że serwer w ogóle nie istnieje. To oznacza, że komunikacja między dwoma serwerami w łańcuchu poszła źle.

Czym 502 różni się od 500, 503 i 504?

Cała rodzina 5xx oznacza problem po stronie serwera, ale każdy kod opisuje inny scenariusz. Bez znajomości tej różnicy łatwo o błędną diagnozę.

Najczęstsza pomyłka: mylenie 502 z 504. Różnica jest jasna, przy 504 origin nie odpowiedział w ogóle (timeout), przy 502 odpowiedział, ale śmieciem (np. zerwane TCP, pusta odpowiedź, nieprawidłowy nagłówek).

Warianty komunikatu 502, co właściwie widzisz?

Sam tekst błędu mówi czasami więcej niż samo “502”. Zależy, kto go zwraca, Cloudflare, Nginx, Apache, IIS czy AWS:

• “502 Bad Gateway”, generyczny, każdy reverse proxy
• “502: Web server received an invalid response while acting as a gateway”, Microsoft IIS
• “Bad Gateway: The proxy server received an invalid response from an upstream server”, Nginx default
• “Error 502: Web server received an invalid response”, Cloudflare
• “502 Server Error”, Google Cloud Load Balancer
• “HTTP 502 Bad Gateway. Service Unavailable”, AWS Application Load Balancer

Jeśli widzisz logo CDN-a (orange chmurka Cloudflare, “CloudFront” w prawym dolnym), problem jest z dużym prawdopodobieństwem między CDN a Twoim origin. Bez logo, bezpośrednio na warstwie reverse proxy lub aplikacji.

Sprawdź też, czy na pewno widzisz 502, a nie inny kod. Błąd 403 Forbidden oznacza blokadę dostępu, nie awarię bramy, a komunikat o przekierowaniu to zupełnie inna sytuacja. Każdy z tych kodów wymaga innej diagnozy.

Co zrobi użytkownik, 5 kroków od najszybszego

Jeśli jesteś po prostu odwiedzającym i chcesz zobaczyć stronę, przejdź przez te kroki w kolejności. Większość 502 znika po 1-3.

1. Odśwież stronę (F5, Ctrl+R, Cmd+R). 502 to często chwilowy problem, wystarczy ponowić żądanie po 10-30 sekundach.
2. Hard refresh (Ctrl+F5 / Cmd+Shift+R). Pomija cache przeglądarki na wypadek, gdyby błąd został wcześniej zacache’owany.
3. Spróbuj innej przeglądarki lub trybu incognito. Wyklucza problem z rozszerzeniami i plikami cookies.
4. Zmień DNS na 1.1.1.1 (Cloudflare) lub 8.8.8.8 (Google). Czasem 502 wynika z propagacji DNS u Twojego ISP.
5. Sprawdź, czy strona działa dla innych. downforeveryoneorjustme.com powie, czy to globalny problem czy lokalny u Ciebie.

Jeśli żaden krok nie pomógł i strona nadal pokazuje 502 po 30 minutach, to po prostu nic z tym nie zrobisz. Problem leży po stronie właściciela strony. Wróć za godzinę.

Diagnoza po stronie admina, drabinka warstw

Jeśli to Twoja strona zwraca 502, problem leży gdzieś w łańcuchu: CDN → reverse proxy → serwer aplikacji → baza danych. Diagnozuj od góry, idąc w dół. Większość 502 ma korzeń w jednej z trzech najwyższych warstw.

Krok 1. CDN / Cloudflare

Wejdź w dashboard CDN-a. Jeśli używasz Cloudflare, sprawdź zakładkę Analytics → Errors. Skok błędów 5xx z konkretnym kodem (520, 521, 522, patrz tabela poniżej) wskazuje, gdzie szukać dalej. Jeśli błąd dotyczy konkretnego URL-a, sprawdź regułę cache / Page Rules.

Krok 2. Reverse proxy (Nginx / Apache / HAProxy)

Logi błędów to pierwsza rzecz, po którą sięga sensowny admin:

• Nginx: /var/log/nginx/error.log, szukaj wpisów upstream prematurely closed connection, connect() failed, upstream timed out
• Apache (mod_proxy): /var/log/apache2/error.log, szukaj proxy: error reading status line from remote server
• HAProxy: /var/log/haproxy.log, kod SH w polu termination_state oznacza server hang-up

Krok 3. Serwer aplikacji (PHP-FPM / Node / Python)

To tu najczęściej leży korzeń. Aplikacja crashuje, ginie OOM-killerem, lub nie nadąża z requestami:

• PHP-FPM: /var/log/php-fpm/error.log + status pool (pm.status_path), szukaj server reached pm.max_children
• Node.js: logi PM2 / systemd, szukaj uncaught exception, EADDRINUSE
• Python (Gunicorn / uWSGI): logi worker’ów, szukaj segfault, signal 11

Krok 4. Baza danych

Mniej oczywiste źródło 502, ale realne. Jeśli aplikacja nie może otworzyć połączenia z bazą (max_connections reached, deadlock, lock wait timeout), worker crashuje i reverse proxy zwraca 502. Sprawdź SHOW PROCESSLIST w MySQL / pg_stat_activity w PostgreSQL.

10 konkretnych przyczyn błędu 502 z poziomu konfiguracji

1. PHP-FPM child pool exhausted. pm.max_children osiągnięty, nowe żądania nie mają w czym się odpalić. Fix: zwiększ pm.max_children lub przejdź na pm = ondemand.
2. Nginx upstream timeout. Default proxy_read_timeout 60s. Długo działający skrypt PHP (export, raport, payment callback) przekracza limit. Fix: zwiększ timeout per location lub przenieś logikę do background job.
3. Origin server OOM killer. Linux kernel zabija proces PHP/Node, bo skończył się RAM. Sprawdź dmesg | grep -i 'killed process'. Fix: więcej RAM-u lub swappiness.
4. SSL handshake failure między CDN a origin. Certyfikat na origin wygasł, self-signed, lub niepoprawny chain. Cloudflare zwraca 525/526. Fix: poprawny certyfikat origin (Let’s Encrypt darmowo).
5. Firewall blokuje IP Cloudflare. mod_security, fail2ban lub iptables blokuje IP CDN-a po fałszywym alarmie. Fix: whitelist IP Cloudflare IP ranges.
6. Wadliwa wtyczka WordPress. Po update’cie wtyczki cały PHP crashuje. Najczęściej winne: cache plugin, security plugin, page builder.
7. DNS resolver na origin. Aplikacja wykonuje sync DNS lookup który nie odpowiada. Fix: dnsmasq z lokalnym cache + IPv4-only jeśli IPv6 niestabilne.
8. Backend listener nie binduje się do portu. Po restarcie systemd jednostka nie wstała, port 9000 (php-fpm.sock) jest pusty. Fix: systemctl status php8.3-fpm.
9. Database connection pool wyczerpany. Aplikacja czeka na free connection, request umiera po timeout. Fix: zwiększ max_connections i wprowadź connection pooling (PgBouncer, ProxySQL).
10. Reverse proxy konfiguracja error. Po edycji nginx.conf brak nginx -t i reload zwraca syntax error, proxy nie potrafi przekierować ruchu. Fix: zawsze nginx -t przed reload.

Cloudflare 520-527, który kod o czym mówi

Jeśli używasz Cloudflare, częściej niż “klasyczne” 502 zobaczysz jedną z odmian 520-527. Każdy z tych kodów to specyficzny scenariusz na linii Cloudflare ↔ origin. Według oficjalnej dokumentacji Cloudflare:

Jeśli widzisz 521, sprawdź firewall na origin, najprawdopodobniej blokuje zakresy IP Cloudflare. Jeśli 522, origin jest przeciążony albo padł. 525/526 to zawsze problem certyfikatu na origin.

Nginx + PHP-FPM, najczęstszy stos i konkretne rozwiązania

Najwięcej polskich stron na WordPressie korzysta z konfiguracji Nginx + PHP-FPM. Jeśli widzisz 502 w takiej konfiguracji, najczęstszym winowajcą jest jedno z trzech.

Problem: PHP-FPM zalany żądaniami

Objaw: upstream prematurely closed connection w error.log. Wpisuj:

tail -f /var/log/nginx/error.log | grep -i upstream

Naprawa w /etc/php/8.3/fpm/pool.d/www.conf:

pm = dynamic
pm.max_children = 50
pm.start_servers = 10
pm.min_spare_servers = 5
pm.max_spare_servers = 15
pm.max_requests = 500

Wartość pm.max_children ustalasz w oparciu o RAM. Średnie zużycie procesu roboczego PHP-FPM to ~40-80 MB. Dla VPS z 4 GB RAM: maksymalnie 40-50 procesów roboczych.

Problem: Nginx upstream timeout

Objaw: upstream timed out w logach + długo trwające żądania (eksport CSV, generowanie PDF, połączenie z external API). Naprawa w nginx.conf per location:

location ~ \.php$ {
    fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
    fastcgi_read_timeout 300s;
    fastcgi_send_timeout 300s;
    fastcgi_connect_timeout 60s;
}

Pamiętaj, to plaster, nie rozwiązanie. Jeśli pojedynczy request trwa 5 minut, problem jest w kodzie, nie w timeoutach.

Problem: socket file permissions

Objaw: connect() to unix:/var/run/php/php8.3-fpm.sock failed (13: Permission denied). Proces Nginx nie może dobić się do PHP-FPM socketu. Naprawa:

listen = /var/run/php/php8.3-fpm.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0660

WordPress, najczęstsze pułapki przy 502

WordPress to dominujący CMS na polskim rynku (według W3Techs ponad 60% rynku CMS-ów globalnie). Większość 502 na WordPressie wynika z kilku źródeł, najczęściej z wtyczek lub limitów PHP. Sprawdź po kolei:

1. Wyłącz wszystkie wtyczki przez FTP. Zmień nazwę katalogu /wp-content/plugins/ na plugins.bak. Jeśli 502 znika, winowajca w pluginach. Włączaj po kolei do skutku.
2. Podnieś memory_limit w wp-config.php:

   define('WP_MEMORY_LIMIT', '512M');
   define('WP_MAX_MEMORY_LIMIT', '768M');

3. Włącz tryb debug: define('WP_DEBUG', true); + define('WP_DEBUG_LOG', true);, logi w /wp-content/debug.log wskażą wtyczkę/funkcję, która rzuca fatalny błąd (fatal error).
4. Sprawdź .htaccess. Częsta przyczyna głupich błędów 502: rozbita reguła rewrite po update’cie permalinków. Zrób kopię, wyzeruj, regeneruj przez Settings → Permalinks → Save.
5. Najczęściej problematyczne wtyczki przy 502: WP Rocket przy nieprawidłowej konfiguracji wstępnego ładowania (preload), WooCommerce przy uszkodzonych transientach, Wordfence przy fałszywych blokadach własnego ruchu.

Jak Googlebot reaguje na 502 i kiedy strona wypada z indeksu

Tu robi się ciekawie. 502 na chwilę jest neutralny. 502 przez kilka dni, Twoja strona znika z Google.

Według oficjalnej dokumentacji Google Search Central:

• “5xx and 429 server errors prompt Google’s crawlers to temporarily slow down with crawling.”, Googlebot zmniejsza częstotliwość crawlowania całej domeny, nie tylko URL-a z błędem.
• “Any content Google receives from URLs that return a 5xx status code is ignored.”, treść z błędem 5xx jest ignorowana, nawet jeśli częściowo wyrenderowała się przed błędem.
• “Already indexed URLs are preserved in the index, but eventually dropped.”, strona wisi w indeksie krótko, ale potem wylatuje.
• “Google’s indexing pipeline removes from the index URLs that persistently return a server error.”, przy powtarzających się błędach 5xx URL jest usuwany z indeksu.

W praktyce z obserwacji GSC po incydentach 502: krótkie incydenty (godziny do 1-2 dni), minimalny impact, Googlebot retry’uje. Wielodniowe ciągłe błędy, wyraźny spadek impressions. Tygodnie nieprzerwanych 502, deindex stron z błędem.

Co ważniejsze, Googlebot pamięta. Po powrocie do stabilności crawl budget odbudowuje się stopniowo. Pełna odbudowa do poprzedniego stanu trwa zwykle 2-4 tygodnie po naprawie.

Implikacja: 502 nie jest “tylko techniczną sprawą”. Każda godzina przestoju kosztuje ruch organiczny. Dlatego monitoring i alerting muszą być na miejscu zanim błąd się pojawi.

Zapobieganie: monitoring + redundancja

Najtańszy 502 to taki, którego nigdy nie zobaczysz. Trzy poziomy obrony:

Monitoring zewnętrzny (synthetic)

• UptimeRobot, darmowy plan: 50 monitorów, ping co 5 min, alert email/SMS. Najprostszy start.
• Better Stack (dawniej Better Uptime), od ~30 zł/mc, ping co 30s, status page, rotacja dyżurów (on-call).
• StatusCake, alternatywa UptimeRobot, podobne ceny.

Monitoring wewnętrzny (APM)

• New Relic, darmowy 100 GB/mc, czas odpowiedzi, error rate per endpoint, slow query log.
• Datadog, droższy, ale infrastructure + APM + logi w jednym.
• Prometheus + Grafana, self-hosted, free, większy nakład pracy konfiguracyjnej.

Redundancja

• Load balancer (Cloudflare Load Balancing, AWS ALB, HAProxy) z health-checkami → automatyczny failover gdy origin pada.
• Statyczna strona zastępcza przy 502 (Cloudflare “Always Online” feature), Googlebot nie widzi 502, widzi HTML z cache.
• Agresywne cache’owanie na poziomie CDN dla cache’owalnych URL-i, nawet jeśli origin padnie, cache odpowiada.

Polski hosting: gdzie najczęściej leci 502

Specyfika polskiego rynku hostingowego, w 2026 r. dominują trzy modele:

Na shared hostingu (cyber_Folks, home.pl, nazwa.pl) prawie nic nie zrobisz na poziomie konfiguracji, możesz tylko zgłosić ticket lub przejść na VPS. Na VPS / dedykowanym serwerze masz pełny dostęp i odpowiedzialność jest po Twojej stronie.

502 na telewizorze, w aplikacji i na Androidzie

Gdy 502 wyskakuje na telewizorze, w aplikacji IPTV albo w apce na telefonie, przyczyna jest ta sama co w przeglądarce: serwer usługi, z którą łączy się aplikacja, zwrócił bramie nieprawidłową odpowiedź. Twoje urządzenie jest sprawne. Po Twojej stronie zostają tylko kroki klienckie, reszta leży na serwerze dostawcy.

502 na Smart TV (YouTube, aplikacja, przeglądarka)

Na telewizorze 502 najczęściej dotyczy jednej aplikacji, nie całego sprzętu. Kolejność działań:

1. Zamknij i otwórz aplikację ponownie. Jednorazowy 502 zwykle znika.
2. Zrestartuj telewizor przez pełne odłączenie od prądu na 30 sekund (cold reboot), nie samym pilotem.
3. Wyczyść pamięć podręczną aplikacji w ustawieniach telewizora albo zainstaluj ją ponownie.
4. Sprawdź, czy ta sama usługa działa na telefonie. Jeśli też pokazuje 502, problem jest po stronie jej serwerów i pozostaje poczekać.
5. Zaktualizuj oprogramowanie telewizora oraz aplikację do najnowszej wersji.

502 w aplikacji na Androidzie

W apce na Androidzie albo w Chrome na telefonie 502 oznacza problem na serwerze usługi, nie w systemie. Co realnie pomaga:

• Przełącz się między Wi-Fi a transmisją komórkową. Czasem trasa do serwera różni się w obu sieciach.
• Wyczyść cache aplikacji: Ustawienia, Aplikacje, dany program, Pamięć, Wyczyść pamięć podręczną.
• Sprawdź datę i godzinę w telefonie. Błędny zegar psuje połączenie TLS i potrafi dać błąd po stronie bramy.
• Zmień DNS na 1.1.1.1 lub 8.8.8.8 w ustawieniach sieci.

502 w IPTV i TiViMate

W odtwarzaczach IPTV (TiViMate, odtwarzacze na Android TV, Formuler, MAG) kod 502 prawie zawsze pochodzi z serwera dostawcy listy albo z proxy, przez które idzie strumień. Szybka diagnoza i naprawa:

1. Sprawdź adres playlisty w innym odtwarzaczu, na przykład w VLC na komputerze. Jeśli tam też leci 502, winny jest dostawca, nie TiViMate.
2. Upewnij się, że subskrypcja jest aktywna i nie wygasła.
3. Usuń i dodaj playlistę (URL m3u) jeszcze raz, odśwież dane EPG.
4. Zmień DNS na urządzeniu. Część dostawców blokuje lub przekierowuje ruch zależnie od DNS.
5. Jeśli nic nie pomaga, zgłoś kod 502 dostawcy. Po jego stronie najczęściej leży przeciążony serwer albo padł reverse proxy.

FAQ

Czym błąd 502 różni się od 504 Gateway Timeout?

502, proxy dostał nieprawidłową odpowiedź z origin. 504, proxy nie dostał żadnej odpowiedzi w terminie (origin milczy do końca timeoutu). Praktycznie: 502 = “śmieci na linii”, 504 = “linia martwa”.

Jak długo zwykle utrzymuje się błąd 502 Bad Gateway?

Zależy od przyczyny. Krótki skok ruchu: 1-5 minut. Awaria PHP-FPM bez automatycznego restartu: do interwencji admina (godziny). Padło data center: nieprzewidywalnie, ale rzadko więcej niż 4-6 godzin. Jeśli widzisz 502 przez 24h+, problem jest strukturalny, nie tylko techniczny incydent.

Czy błąd 502 może wynikać z ataku DDoS lub złośliwego ruchu?

Tak. Atak DDoS warstwy 7 (aplikacyjnej) celowo wyczerpuje pulę PHP workerów lub bazę danych, efekt to błędy 502/504. Atak XML-RPC na WordPressa to klasyk. Ochrona: WAF (Cloudflare, Sucuri), rate limiting na Nginx, wyłączenie nieużywanych endpointów.

Jakie narzędzia diagnostyczne pomogą szybko zidentyfikować przyczynę?

Po kolei: curl -v https://twojadomena.pl (zobacz pełne headers + timing), tail -f na logach reverse proxy + app, panel CDN-a (Analytics), APM (New Relic / Datadog). Dla quick-check publicznie: GTmetrix pokaże, czy strona odpowiada poprawnie z innego regionu.

Czy 502 wpływa na pozycje w Google?

Tak, i to znacznie. Krótkotrwałe 502 (1-2 dni), minimalny impact. Powtarzające się 502 przez tydzień+, spadek crawl budget, spadek impressions, ostatecznie deindex. Patrz sekcja SEO Impact wyżej + Google Search Central docs.

Co oznacza Cloudflare Error 521 vs Error 522?

521, origin odrzuca połączenie (firewall, brak procesu nasłuchującego na porcie). 522, origin nie odpowiada w terminie, ale port jest otwarty. 521 = sprawdź firewall i czy serwis nasłuchuje. 522 = sprawdź obciążenie i wydolność origin.

Czy mogę zobaczyć 502 we własnym sklepie internetowym przy promocji?

Bardzo realne. Skok ruchu (newsletter z promocją, kampania FB Ads, treść wirusowa) zalewa PHP-FPM. Klasyczny scenariusz Black Friday. Przygotowanie: test obciążeniowy (k6, siege) na 7-10 dni przed, skalowanie planu hostingowego, full-page cache CDN.

Co zrobić, jeśli mój hosting shared zwraca 502 i support nie odpowiada?

W kolejności: zgłoszenie techniczne (z konkretem, czas, URL, screenshot), telefon na infolinię, eskalacja przez Twittera (publiczna presja często działa). Długofalowo, jeśli to się powtarza, sygnał na zmianę hostingu. Shared hosting ma sztywne limity, a Twój sąsiad-spamer może zalewać Twoje resources.

Czy błąd 502 może być po stronie mojego internetu / ISP?

Bardzo rzadko, ale możliwe, jeśli ISP używa transparentny proxy lub DPI (Deep Packet Inspection) i ten proxy ma problem. Test: ten sam URL przez mobilny LTE + ten sam URL przez Wi-Fi. Jeśli różnica, problem u ISP. W praktyce 99% błędów 502 jest po stronie serwera docelowego.

Co znaczy „zła brama” i czy to to samo co 502?

„Zła brama” to dosłowne tłumaczenie „Bad Gateway”, więc tak, to ten sam błąd 502. Niektóre przeglądarki i serwery po polsku pokazują właśnie komunikat „502 zła brama”. Znaczenie jest identyczne: serwer pośredniczący dostał nieprawidłową odpowiedź z serwera nadrzędnego.

Czym kod HTTP 502 różni się od samego „502 Bad Gateway”?

To jedno i to samo. „HTTP 502” to numer statusu protokołu HTTP, a „Bad Gateway” to jego oficjalna nazwa. Zapisy „HTTP 502”, „kod 502” i „502 Bad Gateway” opisują dokładnie ten sam stan: błąd na linii między bramą a serwerem nadrzędnym.

Źródła i dalsza lektura

• RFC 9110 §15.6.3, 502 Bad Gateway (oficjalna definicja HTTP)
• MDN Web Docs, 502 Bad Gateway
• Cloudflare, Troubleshooting 5xx errors (520-527)
• Google Search Central, HTTP and network errors
• Nginx, proxy_read_timeout directive

Jeśli Twoja strona zwraca 502 i potrzebujesz pomocy w diagnozie z perspektywy SEO, napisz. Audyt techniczny pokaże, które URL-e zwracają błędy 5xx i jak konkretnie reaguje na nie Googlebot.

Rafał Bajgier

Od 8 lat nieustannie związany z marketingiem internetowym. Zajmuje się kompleksową obsługą przedsiębiorstw w zakresie SEO oraz AI. W wolnym czasie poszerzam swoją wiedzę z zakresu marketingu internetowego.