Komunikat 502 Bad Gateway to sygnał, że na linii komunikacji między różnymi serwerami doszło do przerwania połączenia. W nowoczesnej architekturze Twoje zapytanie rzadko trafia bezpośrednio do celu – zazwyczaj przechodzi przez serwery proxy, firewalle lub systemy równoważenia obciążenia. Błąd 502 oznacza, że jeden z tych "pośredników" otrzymał od serwera znajdującego się głębiej w sieci (np. serwera aplikacji) odpowiedź, której nie potrafił zinterpretować lub która była uszkodzona.
Dlaczego brama zwraca błąd 502?
W przeciwieństwie do błędu 500, który sugeruje awarię wewnątrz skryptu, 502 wskazuje na problem z "dogadaniem się" dwóch usług serwerowych. Najczęstsze techniczne powody to:
- Przeciążenie backendu: Serwer bazy danych lub interpreter PHP jest tak obciążony, że przestał odpowiadać na zapytania od serwera WWW (Nginx/Apache).
- Błędna konfiguracja proxy: Niewłaściwe przekazywanie nagłówków lub zbyt restrykcyjne limity czasu oczekiwania na odpowiedź z backendu.
- Awaria usługi (Crash): Proces obsługujący aplikację (np. PHP-FPM) wyłączył się i brama nie ma komu przekazać żądania użytkownika.
Jak zdiagnozować i naprawić błąd 502?
Rozwiązanie tego problemu wymaga spojrzenia na stronę jako na system naczyń połączonych. Często błąd ten nie leży bezpośrednio w Twoim kodzie, ale w warstwie infrastruktury.
Jeśli korzystasz z usług zewnętrznych w celu przyspieszenia witryny, warto sprawdzić, co to jest CDN i czy jego konfiguracja nie powoduje konfliktów z Twoim serwerem źródłowym. Często błąd 502 znika po poprawieniu komunikacji na linii CDN-Serwer. Niezwykle ważne jest również to, jaki hosting wybrać – tanie rozwiązania współdzielone często mają zbyt niskie limity procesów, co przy nagłym skoku ruchu kończy się "wyłożeniem" backendu i wyświetleniem komunikatu Bad Gateway.
Sprawdź najczęściej spotykane błędy HTTP
Błąd 502 to tylko jeden z wielu kodów z grupy 5xx. Poznaj pozostałe popularne problemy, aby lepiej zrozumieć, jak działa Twoja infrastruktura sieciowa: