502 Bad Gateway oznacza, że serwer działający jako brama lub proxy otrzymał nieprawidłową odpowiedź od serwera nadrzędnego (upstream), z którym połączył się, aby zrealizować żądanie. Samo proxy działa; problem leży za nim.
W typowych konfiguracjach rolę proxy pełni nginx, Apache, load balancer lub CDN, a serwerem nadrzędnym jest serwer aplikacji, np. PHP-FPM, Node.js, Gunicorn lub kontener. „Nieprawidłowa odpowiedź” obejmuje odrzucone lub zresetowane połączenie, awarię w trakcie wysyłania odpowiedzi, błędnie sformatowane nagłówki albo nagłówki większe niż bufory proxy (nginx zapisuje wtedy w logu „upstream sent too big header”).
W Cloudflare problemy z serwerem źródłowym zwykle dają bardziej szczegółowe kody, takie jak 520, 521 lub 522. Zwykły błąd 502 widoczny przez Cloudflare może pochodzić z samego serwera źródłowego albo wynikać z problemu w sieci Cloudflare.
Przykładowa odpowiedź
HTTP/1.1 502 Bad Gateway
Date: Fri, 06 Nov 2026 10:15:32 GMT
Server: nginx
Content-Type: text/html
Content-Length: 142
Connection: keep-alive
<html>
<head><title>502 Bad Gateway</title></head>
<body>
<center><h1>502 Bad Gateway</h1></center>
<hr><center>nginx</center>
</body>
</html>SEO i sprawdzanie przekierowań
Podobnie jak przy innych błędach 5xx, krótkie okresy z błędami 502 spowalniają indeksowanie, ale nie usuwają stron, natomiast utrzymujące się błędy 502 prowadzą do wyindeksowania. Błędy 502 często występują sporadycznie (restart procesu roboczego, zapełniona pula), dlatego sprawdź adres URL kilka razy albo użyj narzędzia Masowe sprawdzanie przekierowań, aby zobaczyć, jak często pojawia się błąd.
Typowe przyczyny i zastosowania
- Serwer aplikacji (PHP-FPM, Node.js, Gunicorn) nie działa, uruchamia się ponownie lub uległ awarii.
- Proxy wskazuje niewłaściwy adres, port lub gniazdo serwera nadrzędnego.
- Nagłówki odpowiedzi serwera nadrzędnego przekraczają bufory proxy (
proxy_buffer_sizelubfastcgi_buffer_sizew nginx). - Zapora lub grupa zabezpieczeń uniemożliwia proxy połączenie z backendem.