Błąd 502 (Bad Gateway) – co to jest i jak go naprawić?

Karolina Nowak
12 września 2025
•
9 minut czytania

Klient wchodzi na Twoją stronę i zamiast oferty widzi krótki komunikat o błędzie. Zwykle nie próbuje jej otworzyć drugi raz – wraca do wyników wyszukiwania i klika w adres konkurencji. Tyle wystarczy, żeby awaria zaczęła być dla Ciebie poważnym kosztem. Dowiedz się więc, skąd bierze się błąd 502 Bad Gateway i jak naprawić go możliwie szybko.

Błąd 502 – co oznacza ten komunikat?

Błąd 502 oznacza, że jeden serwer przekazał zapytanie drugiemu i otrzymał odpowiedź, której nie potrafi odczytać. Strona nadal jest dostępna, ale jeden z serwerów nie otrzymał prawidłowej odpowiedzi od drugiego.

Aby to zrozumieć, warto przyjrzeć się budowie typowej strony internetowej. Rzadko stoi za nią jedno urządzenie. Zwykle jest ich kilka: serwer przyjmujący ruch od użytkowników oraz serwer aplikacji, który faktycznie tworzy zawartość strony. Ten pierwszy pośredniczy w wymianie danych. Kiedy pyta drugiego o treść, a odpowiedź nie przychodzi albo przychodzi niekompletna, przeglądarka wyświetla komunikat o błędzie.

Stąd wzięło się polskie określenie: błąd 502 zła brama. Angielskie „bad gateway” odnosi się właśnie do bramy, która miała przekazać dane dalej, ale nie zdołała tego zrobić poprawnie.

Co oznacza błąd 502 Bad Gateway z perspektywy właściciela firmy?

Z perspektywy właściciela firmy błąd 502 oznacza przede wszystkim to, że strona pozostaje niedostępna dla wszystkich odwiedzających, więc tracone są zapytania i zamówienia. Dodatkowo Google, obserwując powtarzające się błędy serwera 502, ogranicza indeksowanie witryny, a przy dłuższych awariach potrafi obniżyć jej widoczność w wynikach.

Czytaj też: Błąd 503 (Service Unavailable) – przyczyny i skuteczne rozwiązania

Skąd bierze się błąd serwera 502?

Błąd 502 może mieć różne przyczyny i nie zawsze da się od razu wskazać jedno konkretne źródło problemu. Oto najczęstsze powody.

Przeciążenie serwera – nagły wzrost ruchu po kampanii reklamowej albo wzmiance w mediach może doprowadzić do przekroczenia możliwości infrastruktury; aplikacja nie nadąża z odpowiadaniem, a pośrednik przerywa oczekiwanie i wyświetla błąd.

Awaria serwera aplikacji – najczęściej chodzi o wyłączony proces PHP-FPM albo Node.js, który przestał odpowiadać po aktualizacji lub wystąpieniu błędu w kodzie.

Przekroczony limit czasu – jeżeli skrypt wykonuje wymagające zapytanie do bazy danych i nie kończy pracy w wyznaczonym oknie czasowym, połączenie zostaje zerwane.

Wadliwa wtyczka lub motyw – w systemach typu WordPress wystarczy jedno niepoprawnie napisane rozszerzenie, aby zablokować generowanie całej strony.

Problemy z DNS – nieaktualne rekordy albo świeża zmiana serwerów nazw kierują ruch pod adres, który już nie obsługuje witryny.

Zbyt restrykcyjna konfiguracja firewalla lub CDN – warstwa ochronna czasem blokuje prawidłowe połączenie między serwerami, uznając je za próbę ataku.

Błąd 502 Bad Gateway – jak naprawić po stronie użytkownika?

Zanim padnie podejrzenie, że błąd 502 jest efektem problemów po stronie infrastruktury, warto wykonać kilka prostych czynności. Zdarza się bowiem, że komunikat widoczny jest tylko na jednym urządzeniu.

  • Pierwszym krokiem jest odświeżenie strony, najlepiej po kilkudziesięciu sekundach. Spora część takich awarii to chwilowe przeciążenia, które ustępują samoistnie.
  • Następnie warto wyczyścić pamięć podręczną przeglądarki i pliki cookies dla tej witryny, ponieważ przeglądarka mogła zapamiętać nieaktualną odpowiedź.
  • Kolejny krok to sprawdzenie adresu w innej przeglądarce albo na telefonie w sieci komórkowej. Jeżeli tam wszystko działa prawidłowo, przyczyna leży po stronie łącza, ustawień DNS lub rozszerzeń przeglądarki. Wówczas pomaga wyłączenie VPN-a i przełączenie się na publiczne serwery DNS.

Błąd 502 Bad Gateway – jak naprawić jako właściciel strony?

Jeżeli błąd 502 widzą wszyscy odwiedzający, konieczne są działania po stronie serwera. Najlepiej prowadzić je w poniższej kolejności.

  • Punktem wyjścia są logi serwera. Tylko one wskażą, co dokładnie się wydarzyło i o której godzinie. W logach błędów zwykle znajduje się wpis dotyczący przekroczonego limitu czasu, braku połączenia z aplikacją albo konkretnego skryptu, który przestał odpowiadać.
  • Następnie warto ustalić, co zmieniło się tuż przed awarią. Aktualizacja wtyczki? Nowy motyw? Zmiana wersji PHP albo ustawień serwera? W większości przypadków błąd 502 pojawia się po konkretnej modyfikacji, a nie bez przyczyny.
  • Przy stronach opartych na systemie CMS pomocne bywa tymczasowe wyłączenie wszystkich wtyczek i włączanie ich pojedynczo, z obserwacją, przy której witryna znowu przestaje odpowiadać. Metoda jest czasochłonna, ale skuteczna.
  • Warto też zajrzeć do statystyk obciążenia w panelu hostingu. Jeżeli limity pamięci albo procesów regularnie się wyczerpują, sam restart niczego nie rozwiąże – strona przerosła pakiet, na którym działa.

Przy korzystaniu z CDN-u lub zewnętrznej ochrony przed atakami warto wyłączyć je na moment i sprawdzić, czy witryna wraca do normalnej pracy. Zdarza się, że przyczyną są zbyt restrykcyjne ustawienia zabezpieczeń, a nie usterka serwera.

Czytaj też: Błąd 403 (Forbidden) – przyczyny i sposoby naprawy dostępu do strony

Jak ograniczyć ryzyko ponownego pojawienia się błędu 502?

O zabezpieczenia przed błędem 502 najlepiej zadbać, zanim w ogóle dojdzie do awarii. Regularne aktualizacje PHP i wtyczek eliminują sporą część problemów ze zgodnością. Monitoring dostępności sprawia, że informacja o przestoju przychodzi z systemu powiadomień, zanim klienci zdążą się zirytować niedostępnością witryny. Natomiast aktualna kopia zapasowa pozwala szybko wrócić do poprawnie działającej wersji.

Jednak wiele zależy od samej infrastruktury. Serwer z zapasem mocy, dobrze skonfigurowanym cache'owaniem i wsparciem technicznym dostępnym w razie potrzeby po prostu rzadziej zawodzi. A jeżeli już do tego dojdzie, ktoś zajmie się sprawą, zanim odbije się ona na sprzedaży.

Czy wiesz, że… hosting stron www w NQ.pl działa na serwerach LiteSpeed z dyskami NVMe SSD, obejmuje bezpłatny backup do 3 miesięcy wstecz oraz wsparcie techniczne premium bez dodatkowych opłat?

Chcesz zyskać partnera hostingowego, który zapewni szybką reakcję, jeżeli wystąpią błędy po stronie serwera? Skontaktuj się z nami i dowiedz, jak pomożemy Ci zadbać o ciągłość działania witryny firmowej.