502 Bad Gateway to kod błędu HTTP, który oznacza, że serwer działający jako brama lub proxy otrzymał nieprawidłową odpowiedź od serwera nadrzędnego (upstream), do którego próbował się odwołać w celu obsługi żądania użytkownika. Innymi słowy: coś poszło nie tak w komunikacji między serwerami, zanim odpowiedź w ogóle dotarła do przeglądarki. Dla odwiedzającego stronę oznacza to tyle, że witryna jest chwilowo niedostępna — choć przyczyną nie jest jego przeglądarka ani łącze internetowe.
- Błąd 502 leży po stronie serwera, nie użytkownika.
- Najczęściej pojawia się przy przeciążeniu serwera, błędach konfiguracji lub awarii aplikacji backendowej.
- Wpływa na dostępność strony, a przez to — bezpośrednio na SEO i doświadczenie użytkownika.
- Zwykle jest przejściowy, ale powtarzający się błąd wymaga interwencji technicznej.
Jak działa błąd 502 Bad Gateway w praktyce
Błąd 502 pojawia się w warstwie komunikacji między serwerami w architekturze wielopoziomowej. Kiedy użytkownik wpisuje adres strony, żądanie trafia najpierw do serwera brzegowego (np. load balancera, reverse proxy jak Nginx lub CDN jak Cloudflare), który następnie przekazuje je dalej — do serwera aplikacyjnego (np. PHP-FPM, Node.js, Python/Gunicorn). Jeśli ten drugi nie odpowie prawidłowo lub w ogóle nie odpowie, serwer-pośrednik zwraca klientowi właśnie kod 502.
Najczęstsze przyczyny błędu 502
Serwer backendowy przeciążony lub niedostępny to najczęstsza przyczyna błędu 502. Przy nagłym skoku ruchu (np. kampania reklamowa, viralowy post) liczba równoczesnych żądań może przekroczyć możliwości serwera aplikacyjnego — Nginx czeka na odpowiedź, nie dostaje jej w czasie limitu (domyślnie 60 sekund) i odsyła 502. Inne częste scenariusze to:
- Błąd konfiguracji reverse proxy — np. Nginx wskazuje na zły adres IP lub port PHP-FPM (np.
fastcgi_pass 127.0.0.1:9001zamiast poprawnego:9000). - Crash procesu aplikacyjnego — PHP-FPM, Gunicorn lub Node.js przestał działać; serwer nie ma do czego przekazać żądania.
- Problemy z siecią wewnętrzną — firewall blokuje połączenia między serwerami w klastrze, timeout DNS w sieci prywatnej.
- Błędy po stronie CDN — Cloudflare lub inny dostawca CDN nie może dotrzeć do serwera źródłowego (origin server).
- Niekompatybilna odpowiedź upstream — aplikacja zwraca odpowiedź, której proxy nie potrafi sparsować (np. uszkodzone nagłówki HTTP).
502 vs. inne kody błędów serwera — czym się różnią?
Kody z rodziny 5xx zawsze wskazują na problem po stronie serwera, ale każdy oznacza coś innego. Poniższe zestawienie pomaga szybko zidentyfikować źródło problemu:
| Kod | Nazwa | Co oznacza |
|---|---|---|
| 500 | Internal Server Error | Ogólny błąd aplikacji — problem leży w kodzie lub konfiguracji samej aplikacji. |
| 502 | Bad Gateway | Serwer-pośrednik dostał złą/brak odpowiedzi od serwera nadrzędnego. |
| 503 | Service Unavailable | Serwer jest chwilowo niedostępny — przeciążony lub w trybie maintenance. |
| 504 | Gateway Timeout | Serwer-pośrednik czekał zbyt długo na odpowiedź upstream (timeout). |
Jak zdiagnozować błąd 502 krok po kroku
Pierwszym krokiem jest sprawdzenie logów serwera — to najszybszy sposób na identyfikację źródła problemu. W przypadku Nginx zajrzyj do /var/log/nginx/error.log; przy Apache do /var/log/apache2/error.log. Szukaj wpisów z frazami connect() failed, upstream timed out lub no live upstreams.
Następnie sprawdź, czy procesy aplikacyjne w ogóle działają. Polecenie systemctl status php8.2-fpm (lub odpowiedni daemon) pokaże, czy proces jest aktywny. Warto też zweryfikować obciążenie serwera (top, htop) — przy CPU bliskim 100% lub braku wolnej pamięci RAM problem jest jasny. Jeśli korzystasz z Cloudflare, sprawdź w panelu Cloudflare, czy błąd pochodzi od CDN (pojawi się strona błędu z logo Cloudflare) czy od samego origin serwera (strona błędu wygenerowana przez Nginx/Apache).
Znaczenie błędu 502 Bad Gateway dla SEO i widoczności
Błąd 502 ma bezpośredni wpływ na pozycjonowanie strony, ponieważ Googlebot — jak każdy inny klient HTTP — napotyka go podczas crawlowania. Jeśli robot Google trafi na stronę zwracającą 502, nie zaindeksuje jej treści i może w czasie oznaczyć adres URL jako niedostępny. Pojedynczy, krótkotrwały błąd rzadko wyrządza trwałe szkody; jednak jeśli 502 pojawia się regularnie lub trwa dłużej niż kilka godzin, konsekwencje dla pozycjonowania stron są realne.
Google w dokumentacji Search Central potwierdza, że serwery zwracające błędy 5xx przez dłuższy czas mogą tracić zaindeksowane strony — bot zmniejsza częstotliwość crawlowania witryny, a adresy URL znikają z indeksu. Przy pozycjonowaniu sklepów internetowych jest to szczególnie dotkliwe: niedostępne strony produktów lub kategorii oznaczają utratę ruchu organicznego i konwersji jednocześnie. Warto monitorować kody odpowiedzi w Google Search Console (raport „Crawl stats”) — stamtąd dowiesz się, czy Googlebot napotykał błędy 5xx i jak często.
Z perspektywy Core Web Vitals i doświadczenia użytkownika, błąd 502 niszczy metrykę dostępności strony. Każda minuta niedostępności to potencjalni użytkownicy, którzy trafiają na konkurencję — i sygnał dla Google, że witryna nie jest niezawodna.
FAQ — często zadawane pytania o błąd 502
Czy błąd 502 Bad Gateway to wina użytkownika?
Nie — błąd 502 leży całkowicie po stronie serwera. Użytkownik nie może go naprawić przez wyczyszczenie cache przeglądarki ani zmianę DNS-ów, choć takie działania są popularną poradą w internecie. Jedynym wyjątkiem jest sytuacja, gdy dostawca CDN lub DNS po stronie klienta kieruje ruch na nieprawidłowy serwer — ale i wtedy rozwiązanie leży po stronie administratora, nie odwiedzającego.
Jak długo może trwać błąd 502, zanim zaszkodzi pozycji w Google?
Krótkie epizody (kilkanaście minut, kilka razy w miesiącu) zazwyczaj nie powodują trwałego spadku widoczności. Problem zaczyna się, gdy błąd trwa nieprzerwanie kilka godzin lub pojawia się wielokrotnie w ciągu dnia — wtedy Googlebot może obniżyć częstotliwość crawlowania, a strony zaczynają wypadać z indeksu. Sytuację możesz monitorować w Google Search Console w raporcie dotyczącym statystyk crawlowania.
Czym różni się błąd 502 od błędu 504?
Oba błędy dotyczą komunikacji między serwerem-pośrednikiem a serwerem nadrzędnym, ale 502 oznacza nieprawidłową odpowiedź (np. uszkodzone nagłówki, crash aplikacji, zła konfiguracja), a 504 (Gateway Timeout) — że odpowiedź w ogóle nie dotarła w wyznaczonym czasie. W praktyce: 502 częściej sugeruje błąd w aplikacji lub konfiguracji, 504 — przeciążenie lub problem sieciowy między serwerami.
Co zrobić, gdy błąd 502 pojawia się tylko podczas dużego ruchu?
To klasyczny objaw braku skalowalności — serwer aplikacyjny (np. PHP-FPM) ma za mało procesów roboczych, by obsłużyć równoczesne żądania. Rozwiązaniem jest zwiększenie liczby procesów w konfiguracji (parametr pm.max_children w PHP-FPM), skalowanie horyzontalne (dodanie kolejnych serwerów aplikacyjnych) lub wdrożenie mechanizmów kolejkowania żądań. Warto też rozważyć wdrożenie pełnego cache’owania stron (np. Varnish, Redis), by odciążyć backend podczas szczytów ruchu.
Błąd 502 — problem, który warto rozwiązać szybko
Błąd 502 Bad Gateway to jeden z tych problemów technicznych, które widać natychmiast, ale których przyczyna bywa głęboko ukryta w konfiguracji serwera lub architekturze aplikacji. Szybka diagnostyka przez logi i monitoring to fundament — ale jeśli błąd wraca lub nie wiadomo, skąd pochodzi, warto sięgnąć po profesjonalny audyt SEO obejmujący techniczną warstwę witryny. W Webiti regularnie diagnozujemy tego rodzaju problemy jako część kompleksowej pracy nad widocznością stron — zapraszamy do kontaktu.
