HTTP 502 – co oznacza ten błąd

502 pojawia się, gdy serwer działający jako pośrednik – najczęściej reverse proxy albo load balancer przed Twoją aplikacją – dostaje od serwera źródłowego (backendu, czyli np. procesu PHP-FPM) odpowiedź, której nie da się poprawnie zinterpretować, albo nie dostaje jej wcale. To błąd komunikacji między warstwą, która odbiera ruch z internetu, a warstwą, która faktycznie generuje stronę. Sam serwer źródłowy mógł się w tym momencie wywalić, zrestartować albo w ogóle nie odpowiedzieć.

Co to oznacza w praktyce na stronie WordPress

Na hostingu z architekturą proxy plus PHP-FPM 502 najczęściej oznacza, że proces PHP-FPM padł albo się zrestartował w trakcie obsługi żądania – zwykle pod wpływem dużego obciążenia albo błędu krytycznego w kodzie, który zabił cały proces, a nie tylko jedno żądanie. Bywa też skutkiem chwilowego przeciążenia serwera – zbyt wiele równoległych żądań przy niewielkim limicie procesów PHP na hostingu współdzielonym. Zdarza się po migracji albo zmianie konfiguracji serwera, gdy proxy wskazuje na nieprawidłowy adres backendu. W praktyce 502 bywa przelotny – jedno odświeżenie i strona wraca – co samo w sobie jest sygnałem, że backend miał chwilowy problem, a nie trwałą awarię.

Co sprawdzić

• Logi PHP-FPM i logi błędów serwera – tam widać restart procesu albo przyczynę jego śmierci
• Zużycie CPU i RAM w momencie wystąpienia błędu (panel hostingu albo dane od wsparcia)
• Czy błąd jest jednorazowy, czy powtarza się regularnie – jednorazowy to zwykle chwilowy skok obciążenia, powtarzalny to konfiguracja albo wadliwy kod
• Ostatnie zmiany na serwerze – migracja, aktualizacja stosu PHP, zmiana limitów procesów