Błąd 502 Bad Gateway to komunikat HTTP oznaczający, że serwer pośredniczący (np. serwer proxy, brama sieciowa, CDN lub load balancer) otrzymał nieprawidłową odpowiedź od innego serwera, z którym próbował się połączyć. Najczęściej jest to chwilowy problem z komunikacją pomiędzy serwerami, ale może też świadczyć o nieprawidłowej konfiguracji lub przeciążeniu infrastruktury.
Spis treści
Co dokładnie oznacza błąd 502?
Błąd 502 należy do grupy kodów HTTP z serii 5xx, czyli błędów po stronie serwera. W tym przypadku problem nie dotyczy serwera użytkownika, lecz serwera działającego jako pośrednik, który nie potrafi poprawnie przekazać żądania dalej – bo nie otrzymał odpowiedzi lub odpowiedź była uszkodzona.
Taki błąd pojawia się m.in. w architekturach opartych o reverse proxy (np. Nginx), sieci dostarczania treści (CDN, np. Cloudflare), a także tam, gdzie występuje równoważenie obciążenia (load balancing).
Najczęstsze przyczyny błędu 502
- Problemy z serwerem docelowym
Serwer źródłowy może być przeciążony, chwilowo niedostępny lub mieć błędną konfigurację, która uniemożliwia odpowiedź. - Błąd po stronie usług pośredniczących
CDN, proxy lub firewall mogą mieć problem z przesłaniem żądania – np. przez timeout, niekompatybilną odpowiedź lub błąd nagłówków. - Niestabilność sieci
Awarie lub opóźnienia w komunikacji między serwerami mogą spowodować, że dane nie dotrą na czas lub w niepełnej formie. - Nieprawidłowa konfiguracja DNS
Błędne rekordy DNS (np. A lub CNAME) mogą kierować ruch do nieistniejącego lub niewłaściwego serwera, co kończy się błędem bramy.
Czy błąd 502 wpływa na działanie strony?
Tak – użytkownik końcowy widzi niedziałającą stronę. Jeśli problem występuje często lub długo, może wpłynąć negatywnie na wizerunek, konwersję oraz pozycję w wynikach wyszukiwania. W przypadku serwisów o dużym ruchu, jak sklepy internetowe czy portale informacyjne, nawet chwilowa niedostępność może oznaczać realne straty.
Jak reagować na błąd 502?
Dla użytkownika najprostsze rozwiązanie to odświeżenie strony po chwili. Jeśli jesteś właścicielem strony, sprawdź logi serwera, czas odpowiedzi backendu, statusy połączeń z usługami pośredniczącymi oraz konfigurację DNS. W przypadku korzystania z CDN, np. Cloudflare, warto również sprawdzić, czy nie ma ogólnosystemowych problemów po ich stronie.
