Przejdź do treści

Tworzenie stron internetowych

HTTP 502 Bad Gateway: co oznacza i jak skutecznie naprawić błąd 502 Bad Gateway?

Dowiedz się, co oznacza błąd 502 Bad Gateway i jak skutecznie go naprawić na stronie internetowej.

Przejdź do treści

Błąd 502 Bad Gateway oznacza, że serwer pośredniczący, np. serwer proxy, CDN albo bramka hostingu, otrzymuje nieprawidłową odpowiedź od serwera nadrzędnego, który miał przygotować stronę. Problem prawie nigdy nie leży w Twoim komputerze, ale kilka prostych kroków pozwala to sprawdzić. Poniżej wyjaśniamy, skąd się bierze ten komunikat, co może zrobić odwiedzający, jak diagnozuje go administrator i jak uniknąć go w przyszłości.

Czym jest błąd 502?

502 Bad Gateway to kod odpowiedzi HTTP z grupy 5xx, czyli błędów po stronie serwera. W angielskiej dokumentacji spotkasz go jako error 502 albo status code 502. Kod 502 oznacza, że serwer, który pośredniczy w ruchu, nie dostał poprawnej odpowiedzi od serwera, do którego przekazał żądanie. To błąd komunikacji między serwerami, a nie problem z Twoim łączem. Mówiąc prościej: "bramka" działa, ale to, co stoi za nią, milczy, odpowiada za późno albo zwraca dane w złym formacie.

Mechanizm wygląda tak:

  1. Przeglądarka wysyła żądanie do serwera pośredniczącego, np. Nginx działającego jako reverse proxy albo load balancer.
  2. Ten serwer przekazuje żądanie dalej, do backendu, czyli aplikacji, która generuje treść (np. PHP-FPM z WordPressem).
  3. Backend, czyli serwer docelowy, nie odpowiada, zrywa połączenie albo zwraca coś, czego bramka nie rozumie.
  4. Bramka nie ma czego oddać przeglądarce, więc zwraca komunikat 502.

Ten sam problem może mieć różną nazwę na ekranie: "502 Bad Gateway nginx", "HTTP Error 502", "The proxy server received an invalid response" (serwer proxy otrzymał nieprawidłową odpowiedź) czy własna strona błędu hostingu lub Cloudflare.

Czym 502 różni się od innych błędów serwera?

Kod

Nazwa

Co oznacza błąd

500

Internal Server Error

aplikacja wywróciła się sama, np. przez błąd w skrypcie

502

Bad Gateway

pośrednik dostał złą odpowiedź od innego serwera

503

Service Unavailable

serwer świadomie odmawia, np. przy przeciążeniu lub pracach technicznych

504

Gateway Timeout

pośrednik nie doczekał się odpowiedzi w ustalonym czasie

Błąd 504 Gateway Timeout jest najbliższym krewnym 502: w obu przypadkach problem dotyczy połączenia między serwerami, ale w tym drugim przypadku backend po prostu nie zdążył odpowiedzieć.

Najczęstsze przyczyny błędu 502 Bad Gateway

Za większością przypadków stoi jedna z poniższych sytuacji:

  • Backend nie działa. Proces aplikacji został zatrzymany, restartuje się po aktualizacji albo system zabił go z braku pamięci. Serwer WWW żyje, ale nie ma z kim rozmawiać.
  • Przekroczony limit czasu. Skrypt pracuje dłużej, niż pozwala czas oczekiwania ustawiony na bramce, więc ta przerywa połączenie, mimo że backend wciąż liczy.
  • Błędna konfiguracja. Zły adres lub port backendu, literówka w nazwie gniazda PHP-FPM albo za małe bufory na nagłówki odpowiedzi.
  • Przeciążenie i wyczerpane zasoby serwera. Duży ruch po kampanii, atak botów albo zbyt mało procesów PHP sprawiają, że kolejka zapytań rośnie szybciej, niż serwer je obsługuje.
  • Problemy sieciowe i zabezpieczenia. Firewall lub zapora hostingu blokuje adresy IP dostawcy CDN, a ten nie może połączyć się z serwerem źródłowym.
  • DNS. Po migracji domena lub nazwa backendu wskazuje na stary adres.

W WordPressie częstym winowajcą jest dodatkowo ciężka lub źle napisana wtyczka, zwłaszcza od bezpieczeństwa i buforowania stron (cache).

Co zrobić, gdy widzisz błąd 502? Kroki dla odwiedzającego

Odwiedzający ma niewielkie pole manewru, bo problem leży po stronie serwera. Kilka ruchów pozwala jednak wykluczyć własny sprzęt:

  1. Odśwież stronę (F5 lub Ctrl + R) po minucie. Wiele awarii mija samoistnie, gdy serwer złapie oddech.
  2. Otwórz adres w trybie incognito. Jeśli działa, winne są dane przeglądarki lub rozszerzenia.
  3. Wyczyść pamięć podręczną przeglądarki i ciasteczka.
  4. Wyłącz rozszerzenia i VPN, zwłaszcza blokery reklam.
  5. Uruchom ponownie router i opróżnij pamięć podręczną DNS (w Windows: ipconfig /flushdns).
  6. Sprawdź stronę z innego urządzenia i innej sieci, np. telefonu na danych komórkowych.

Pewniejszy obraz da serwis Down For Everyone Or Just Me, który sprawdza adres ze swoich serwerów. Jeśli dla niego strona też nie działa, awaria dotyczy właściciela i pozostaje poczekać albo dać mu znać. Jeśli działa tylko u Ciebie, szukaj przyczyny lokalnie: w DNS, VPN lub dodatkach przeglądarki.

Potrzebujesz wsparcia w marketingu?

Bezpłatnie ocenimy Twój marketing i zaproponujemy konkretny plan działania - bez zobowiązań.

Bezpłatna wycena

Diagnostyka dla administratora - sprawdź logi i konfigurację

Tu wszystko sprowadza się do pytania, w którym miejscu łańcucha od bramki do aplikacji gubi się odpowiedź. Kolejność, która oszczędza najwięcej czasu:

  1. Status usług. Sprawdź, czy działa serwer WWW i proces aplikacji, np. systemctl status php-fpm. Maszyna może działać, a PHP-FPM, Node czy Gunicorn leżeć po zabiciu przez brak pamięci.
  2. Dziennik bramki. W konfiguracji Nginx błędy domyślnie trafiają do error.log. Wpis "connect() failed" oznacza, że backend nie przyjmuje połączeń, a "upstream prematurely closed connection" mówi, że przerwał odpowiedź w połowie.
  3. Logi aplikacji. W WordPressie włącz WP_DEBUG_LOG i przejrzyj plik debug.log.
  4. Rekordy DNS. Upewnij się, że domena i nazwa backendu wskazują na właściwy adres IP, zwłaszcza po migracji.
  5. Test z pominięciem bramki. Wywołaj backend bezpośrednio z serwera, np. curl na lokalny port, i porównaj z wynikiem przez publiczny adres.

Ostatni krok najszybciej zawęża problem. Jeśli bezpośrednio wszystko odpowiada, a przez bramkę pojawia się 502, winna jest konfiguracja serwera proxy albo sieć między nimi. Gdy backend nie odpowiada także bezpośrednio, szukaj w aplikacji i jej zasobach. Przy stronie za content delivery network (CDN) dochodzi test z tymczasowym wyłączeniem tej usługi: jeśli to pomaga, sprawdź, czy zapora nie odrzuca adresów dostawcy.

Jak usunąć błąd? Najczęstsze poprawki

  • Restart usług, najpierw PHP-FPM, potem serwera WWW. Przywraca działanie, ale nie usuwa przyczyny, więc wróć potem do dziennika błędów.
  • WordPress: zmień nazwę katalogu wp-content/plugins przez FTP lub SSH, żeby wyłączyć wszystkie rozszerzenia naraz, a potem włączaj je pojedynczo. To samo zrób z motywem, przełączając na domyślny.
  • Czasy oczekiwania: w Nginx odpowiadają za nie dyrektywy proxy_connect_timeout, proxy_read_timeout i fastcgi_read_timeout. Wydłużaj je tylko wtedy, gdy wolne zapytanie jest uzasadnione, bo inaczej zamaskujesz problem z wydajnością.
  • Bufory: jeśli dziennik pokazuje informację o zbyt dużych nagłówkach, zwiększ proxy_buffer_size lub fastcgi_buffer_size.
  • Zasoby: gdy dziennik pokazuje brak pamięci albo brak wolnych procesów PHP, sama korekta ustawień nie pomoże. Potrzebny jest większy plan lub optymalizacja aplikacji.

Jeśli przyczyna tkwi w infrastrukturze dostawcy, np. awarii węzła współdzielonego serwera, zostaje zgłoszenie do supportu hostingu z fragmentami dziennika i godziną wystąpienia błędu.

Kiedy zmienić plan hostingowy?

Zmiana planu ma sens, gdy błędy wracają regularnie i pokrywają się z obciążeniem. Zestaw godziny błędów z wykresami ruchu i zużycia zasobów w panelu hostingu. Jeśli 502 pojawia się w trakcie kampanii, wysyłki newslettera albo wyprzedaży, a poza tym strona działa bez zarzutu, problemem jest wydajność, nie ustawienia.

Zanim kupisz droższy pakiet, odzyskaj zasoby za darmo: wyłącz ciężkie dodatki, włącz cache stron i ogranicz ruch botów. Jeśli limity nadal są na granicy, wybierając nowy plan patrz na konkretne parametry: pamięć RAM na konto, liczbę równoległych procesów PHP, gwarantowany czas procesora i możliwość przejścia na VPS lub chmurę bez migracji od zera.

Jak zapobiegać błędom 502? Monitoring i testy obciążeniowe

Zapobieganie zaczyna się od nadzoru, który sprawdza więcej niż samo "strona działa". Dobre narzędzie, np. UptimeRobot czy Better Stack, zapisuje kod odpowiedzi i czas ładowania, a alarmuje, gdy ten czas rośnie. Spowolnienie zwykle poprzedza awarię, więc masz margines na reakcję, zanim użytkownicy zobaczą błąd.

Druga warstwa to redundancja. Bramka powinna kierować ruch tylko do zdrowych instancji aplikacji, a to wymaga co najmniej dwóch. W Nginx można to skonfigurować w bloku upstream: przy każdym serwerze ustawiasz max_fails=3, czyli liczbę nieudanych prób, po której serwer jest pomijany, oraz fail_timeout=30s, czyli czas przerwy przed kolejną próbą.

Trzeci element to testy obciążeniowe. Seria zapytań o rosnącej liczbie, wysłana na środowisku testowym lub poza szczytem, np. w k6, JMeterze lub Postmanie, pokazuje próg wytrzymałości. Porównasz go z prognozowanym ruchem przed kampanią i dołożysz zasoby przed wydarzeniem, a nie po nim. Regularnie sprawdzaj ten próg po większych zmianach: nowym dodatku, aktualizacji PHP czy zmianie ustawień bramki.

Wpływ błędu 502 na SEO i użytkowników

Według dokumentacji Google kody 5xx sprawiają, że roboty wyszukiwarki tymczasowo zwalniają skanowanie witryny, a treść zwróconą razem z błędem ignorują. Spadek tempa jest proporcjonalny do liczby adresów, które zwracają taki błąd. Pojedyncza, krótka awaria nie zaszkodzi pozycjom, bo robot wróci później. Adresy, które uporczywie zwracają 502, zostaną jednak z czasem usunięte z indeksu, a więc i z wyników wyszukiwania.

Dla użytkownika każda przerwa to frustracja, porzucone koszyki i mniejsze zaufanie do marki. W serwisach z płatnościami czy integracjami jeden niedziałający element potrafi pociągnąć za sobą kolejne usługi. Dlatego problemy z błędem 502 warto traktować jak problem biznesowy, nie tylko techniczny, zwłaszcza w sklepie, który płaci za ruch z reklam.

Potrzebujesz wsparcia w marketingu?

Bezpłatnie ocenimy Twój marketing i zaproponujemy konkretny plan działania - bez zobowiązań.

Bezpłatna wycena

Co zgłosić administratorowi lub supportowi?

Zgłoszenie jest przydatne, gdy pozwala szybko znaleźć wpis w logach. Podaj:

  • dokładny czas pierwszego i ostatniego wystąpienia błędu wraz ze strefą czasową,
  • pełny adres URL, który zwrócił komunikat,
  • zrzut ekranu strony błędu, bo jej wygląd zdradza, która warstwa ją wygenerowała,
  • informację, czy błąd dotyczy całej witryny, czy jednej podstrony, i czy występuje stale, czy co jakiś czas,
  • wynik testu z innej sieci oraz to, co zmieniło się tuż przed awarią.

Wzorzec też podpowiada przyczynę. Błędy w szczycie ruchu wskazują na przeciążenie, te tuż po wdrożeniu na świeże zmiany, a błąd na jednej podstronie na konkretny skrypt.

Ile warto zainwestować w ochronę przed błędem 502?

Typ witryny

Ryzyko przestoju

Sensowne zabezpieczenia

sklep z kampaniami

wysokie: tracone zamówienia i budżet reklamowy

kilka instancji backendu, alerty, testy obciążeniowe

serwis z API i integracjami

wysokie: awaria rozlewa się na inne usługi

redundancja, alerty, osobne testy bramki i backendu

blog lub portal

średnie, zależne od ruchu z Google

buforowanie stron, alerty dostępności, plan z zapasem

strona wizytówka

niskie

darmowy test dostępności i kopia zapasowa

Prosty rachunek: pomnóż średnią wartość zamówień na godzinę przez liczbę godzin niedostępności w roku. Jeśli wynik przewyższa koszt mocniejszego planu z drugim serwerem, decyzja jest oczywista. Mała firma bez własnego administratora zwykle zyska więcej na hostingu zarządzanym, w którym dostawca bierze na siebie warstwę serwerową.

Najczęściej zadawane pytania

Czy błąd 502 to wina mojego komputera?

Prawie nigdy. To błąd serwera, a nie Twojego sprzętu. Wyjątkiem są uszkodzone dane przeglądarki, VPN lub rozszerzenia, które sprawdzisz w trybie incognito i na innym urządzeniu.

Jak długo trwa błąd 502?

Chwilowe przeciążenie mija zwykle po kilku sekundach lub minutach. Jeśli komunikat utrzymuje się dłużej niż kilkanaście minut, najpewniej padła usługa za bramką i potrzebna jest interwencja.

Błąd 502 na stronie Cloudflare - co to znaczy?

Strona błędu Cloudflare pokazuje, który element łańcucha nie działa: przeglądarka, Cloudflare czy serwer źródłowy. Gdy problem dotyczy serwera źródłowego, właściciel witryny musi sprawdzić hosting i zaporę, a nie ustawienia Cloudflare.

Udostępnij
↳Powiązane wpisy

Czytaj dalej.

Wszystkie wpisy