502 Bad Gateway: co to znaczy i jak naprawić błąd 502

502 Bad Gateway oznacza, że serwer pośredniczący (np. Cloudflare albo nginx) nie dostał poprawnej odpowiedzi od serwera, na którym działa strona. Problem leży po stronie strony albo jej hostingu, a nie Twojego komputera. Jako odwiedzający zwykle możesz tylko odświeżyć stronę po chwili. Jeśli to Twoja strona, poniżej znajdziesz najczęstsze przyczyny i sposób naprawy.

502 Bad Gateway: co to znaczy?

Zanim strona trafi do Twojej przeglądarki, często przechodzi przez kilka serwerów. Najpierw jest np. Cloudflare, potem serwer WWW (nginx albo Apache), a na końcu program, który buduje stronę, np. PHP. Jeśli ostatni element nie odpowie albo odpowie błędnie, serwer pośredniczący (bramka, ang. gateway) zwraca kod 502.

Komunikat wygląda różnie, zależnie od serwera:

• 502 Bad Gateway,
• 502 Bad Gateway nginx,
• HTTP Error 502 albo Error 502,
• 502 Proxy Error,
• strona błędu Cloudflare z napisem Bad gateway.

Jak naprawić błąd 502 jako odwiedzający

1. Odczekaj minutę i odśwież stronę (F5). Błąd 502 często wynika z chwilowego przeciążenia serwera.
2. Otwórz stronę w oknie incognito albo w innej przeglądarce. Jeśli tam działa, wyczyść pamięć podręczną i ciasteczka swojej przeglądarki.
3. Sprawdź stronę na telefonie z danymi komórkowymi. Jeśli działa, problem może leżeć w Twojej sieci. Zrestartuj router albo wyczyść pamięć DNS w systemie Windows poleceniem ipconfig /flushdns.
4. Jeśli nic nie pomaga, błąd jest po stronie strony. Możesz tylko poczekać albo dać znać jej właścicielowi.

Najczęstsze przyczyny błędu 502 na Twojej stronie

• Przeciążony serwer: za mały pakiet hostingu, nagły wzrost ruchu albo atak botów.
• PHP przestało odpowiadać: proces PHP-FPM padł albo skończyły mu się wolne procesy.
• Zbyt długo działający skrypt, np. import produktów, kopia zapasowa albo ciężka wtyczka.
• Wadliwa wtyczka lub motyw, które zawieszają PHP.
• Problemy z DNS: domena wskazuje stary albo zły serwer, np. po przeprowadzce strony.
• Zapora serwera blokuje Cloudflare, więc Cloudflare nie może pobrać strony.
• Awaria hostingu.

Jak naprawić 502 Bad Gateway na swojej stronie

1. Sprawdź, czy to nie awaria hostingu

Zajrzyj na stronę statusu swojego hostingu albo do jego mediów społecznościowych. Jeśli inne strony na tym samym serwerze też nie działają, napisz do pomocy technicznej i podaj godzinę błędu. Przy awarii po stronie hostingu sam nic nie naprawisz.

2. Sprawdź Cloudflare

Strona błędu Cloudflare pokazuje, które ogniwo zawiodło: Twoja przeglądarka, Cloudflare czy serwer strony (Host). Jeśli błąd jest przy serwerze, problem leży w hostingu, a nie w Cloudflare.

Jeśli błąd dotyczy Cloudflare, sprawdź, czy zapora na serwerze nie blokuje adresów IP Cloudflare. Możesz też na chwilę wstrzymać Cloudflare dla domeny (opcja Pause Cloudflare on Site) i sprawdzić, czy strona działa bez niego.

3. Wyłącz wtyczki i motyw

Jeśli błąd pojawił się po instalacji lub aktualizacji wtyczki, wyłącz ją. Bez dostępu do kokpitu zmień nazwę folderu wp-content/plugins, np. na plugins-off. Potem przywróć nazwę i włączaj wtyczki po kolei. Tak samo sprawdzisz motyw. Dokładnie opisałem to w poradniku o błędzie 500.

4. Przejrzyj logi serwera

W panelu hostingu znajdziesz log błędów (Error log). Przy błędzie 502 często pojawiają się tam wpisy w rodzaju:

upstream prematurely closed connection while reading response header from upstream
connect() failed (111: Connection refused) while connecting to upstream

Oba oznaczają, że nginx nie mógł porozmawiać z PHP albo z aplikacją stojącą za nim. Pierwszy wskazuje zwykle na zbyt długi skrypt lub awarię PHP, drugi na to, że PHP w ogóle nie działa.

5. Zwiększ limity czasu i zasobów PHP

Na hostingu współdzielonym podniesiesz max_execution_time i memory_limit w ustawieniach PHP w panelu. Na własnym serwerze VPS możesz też wydłużyć czas oczekiwania nginx na PHP i zwiększyć liczbę procesów PHP-FPM:

# nginx, w bloku server lub location obsługującym PHP
fastcgi_read_timeout 300;

# php.ini
max_execution_time = 300

# pula PHP-FPM, np. www.conf
pm.max_children = 20

Wartość pm.max_children dobierz do ilości pamięci RAM serwera. Po zmianach zrestartuj PHP-FPM i nginx.

6. Sprawdź DNS domeny

Jeśli niedawno przenosiłeś stronę albo zmieniałeś rekordy DNS, domena może jeszcze wskazywać stary serwer. Zmiany DNS rozchodzą się zwykle do kilku godzin, rzadko do 48 godzin. Jak sprawdzić, gdzie wskazuje domena, opisałem we wpisie jak sprawdzić hosting domeny.

7. Zmień pakiet albo hosting

Jeśli błąd 502 wraca przy większym ruchu, serwer po prostu nie daje rady. Wybierz wyższy pakiet albo szybszy hosting. Porównanie sprawdzonych firm znajdziesz w moim rankingu hostingów.

502 Bad Gateway nginx: co to znaczy?

Dopisek nginx oznacza, że serwer WWW działa, ale aplikacja za nim nie odpowiada. Na serwerze z WordPressem jest to prawie zawsze PHP-FPM. Sprawdź, czy usługa działa (np. polecenie systemctl status php8.3-fpm, z właściwą wersją PHP) i czy ścieżka do gniazda PHP w konfiguracji nginx zgadza się z ustawieniami PHP-FPM.

Jeśli nginx przekazuje ruch do aplikacji Node.js albo kontenera Docker, upewnij się, że aplikacja jest uruchomiona i nasłuchuje na porcie podanym w proxy_pass, np. localhost:3000. Więcej o portach przeczytasz we wpisie co to jest localhost.

Błąd 502 a 500, 503 i 504

Kod	Nazwa	Co oznacza
500	Internal Server Error	Ogólny błąd serwera, najczęściej w kodzie strony.
502	Bad Gateway	Serwer pośredniczący dostał błędną odpowiedź albo nie dostał żadnej.
503	Service Unavailable	Serwer jest chwilowo niedostępny, np. przez przeciążenie albo prace techniczne.
504	Gateway Timeout	Serwer pośredniczący czekał na odpowiedź zbyt długo.

Czy błąd 502 szkodzi SEO?

Kilkuminutowa awaria nie ma znaczenia. Google wróci później. Jeśli błąd trwa kilka dni, Google ograniczy odwiedziny strony i może zacząć usuwać podstrony z indeksu. Błędy serwera zobaczysz w Google Search Console w raporcie „Statystyki indeksowania”.

Najczęstsze pytania

502 Bad Gateway: co to znaczy w skrócie?

Serwer pośredniczący nie dostał poprawnej odpowiedzi od serwera ze stroną. Strona jest chwilowo niedostępna z powodu problemu po jej stronie.

Czy błąd 502 to wina mojego internetu?

Zwykle nie. Jeśli inne strony działają, a ta jedna pokazuje błąd 502 także na telefonie z danymi komórkowymi, problem leży po stronie strony.

Ile trwa błąd 502?

Przy przeciążeniu serwera mija zwykle po kilku minutach. Gdy przyczyną jest awaria albo błędna konfiguracja, błąd zostanie, dopóki administrator go nie naprawi.