Błąd 502 Bad Gateway - co oznacza i jak go naprawić

Błąd 502 oznacza, że serwer pośredniczący (np. nginx lub CDN) nie dostał poprawnej odpowiedzi od właściwej aplikacji.

Co oznacza błąd 502?

Większość stron działa na dwóch warstwach: serwer WWW lub CDN przyjmuje ruch i przekazuje go do aplikacji (PHP, Node.js, Python). Kod 502 znaczy, że ta druga warstwa nie odpowiedziała poprawnie - zwykle padła albo się restartuje.

Najczęstsze przyczyny

• Awaria lub restart aplikacji (np. PHP-FPM, Node.js).
• Aplikacja się wysypała przez brak pamięci.
• Błędna konfiguracja proxy - zły port lub adres aplikacji.
• Przeciążenie przy dużym ruchu.

Co zrobić, gdy widzisz błąd 502?

• Odśwież stronę za minutę - błąd 502 często mija sam po restarcie aplikacji.
• Sprawdź, czy strona działa u innych (np. na naszej stronie „Czy działa?”).

Jak naprawić błąd 502 na swojej stronie?

• Sprawdź, czy proces aplikacji działa (np. systemctl status php-fpm albo docker ps).
• Przejrzyj logi serwera WWW - zwykle podają, z jakim adresem nie udało się połączyć.
• Sprawdź zużycie pamięci - zabite przez system procesy to częsta przyczyna.
• Ustaw monitoring, który powiadomi Cię o 502, zanim zgłoszą go klienci.

Podobne kody