Sprawdzone
2026-11-14
/ 502 Bad Gateway

502 Bad Gateway: nginx działa, aplikacja za nim nie.

Błąd 502 z nginx oznacza, że sam nginx działa, ale od tego, co stoi za nim, nie dostał poprawnej odpowiedzi. Za nim jest PHP-FPM, aplikacja w Node albo Pythonie albo kolejny proxy. Który z nich zawiódł, mówi log błędów, zwykle w jednej linijce.

Najpierw przeczytaj log błędów

Każdy błąd 502 zostawia wpis w logu błędów nginx. W Debianie i Ubuntu to /var/log/nginx/error.log, chyba że konfiguracja strony wskazuje inny plik dyrektywą error_log.

tail -n 50 /var/log/nginx/error.log

Odśwież stronę raz, obserwując log przez tail -f. Liczy się najnowsza linijka. Słowa po numerze błędu mówią, gdzie szukać.

Co znaczy wpis w logu

  • connect() to unix:/run/php/php8.3-fpm.sock failed (2: No such file or directory): PHP-FPM nie działa albo nginx wskazuje gniazdo wersji PHP, której już nie ma. ls /run/php/ pokazuje, jakie gniazda istnieją.
  • Ten sam wpis z (13: Permission denied): właściciel albo uprawnienia gniazda nie wpuszczają użytkownika nginx. Porównaj listen.owner, listen.group i listen.mode w puli PHP-FPM z użytkownikiem, na którym działa nginx.
  • connect() failed (111: Connection refused) while connecting to upstream: pod adresem z proxy_pass albo fastcgi_pass nic nie nasłuchuje. Aplikacja padła albo słucha na innym porcie.
  • upstream prematurely closed connection while reading response header from upstream: aplikacja przyjęła żądanie i padła albo została zabita w trakcie odpowiedzi. Powód jest w jej własnym logu albo w dmesg, jeśli zadziałał OOM killer.
  • upstream sent too big header while reading response header from upstream: aplikacja wysłała nagłówki, zwykle ciasteczka, większe niż bufor nginx. Zwiększ proxy_buffer_size, a dla PHP fastcgi_buffer_size, stopniowo.

Typowe naprawy, po kolei

Zamiast php8.3-fpm wpisz swoją wersję PHP albo nazwę swojej usługi.

  1. systemctl status php8.3-fpm, albo usługa twojej aplikacji, pokazuje, czy działa, i jej ostatnie wpisy w logu. systemctl list-units --type=service | grep -i fpm znajduje właściwą nazwę.
  2. systemctl restart php8.3-fpm podnosi zatrzymaną usługę. Jeśli po kilku minutach znowu się zatrzymuje, restart nie był naprawą: journalctl -u php8.3-fpm -n 100 powie dlaczego.
  3. Dla aplikacji za proxy_pass ss -tlnp pokazuje, co nasłuchuje na jakim porcie. curl -I http://127.0.0.1:3000, z portem twojej aplikacji, pyta aplikację bezpośrednio, z pominięciem nginx.
  4. Po każdej zmianie w konfiguracji nginx -t ją sprawdza, a systemctl reload nginx wczytuje bez zrywania połączeń.

Czego nie robić

  • Nie zaczynaj od restartu całego serwera. Jeśli PHP-FPM zabrakło procesów albo pamięci, błąd 502 wróci, a wpisy w logu, które by to pokazały, trudniej będzie potem znaleźć.
  • Nie podnoś wszystkich limitów czasu i buforów naraz. 502 to nie przekroczenie czasu; to byłby błąd 504, który ma inne przyczyny.
  • Nie zostawiaj aktualizacji PHP w połowie. Jeśli stary pakiet PHP został usunięty, konfiguracja strony musi wskazywać gniazdo nowej wersji.

Kiedy oddać sprawę

Przestań, jeśli usługa pada po każdym restarcie, jeśli log wskazuje na pamięć albo awarię, której nie umiesz wyjaśnić, albo jeśli strona przyjmuje płatności i każda godzina kosztuje. Nasze Ratowanie serwera to jeden incydent za stałą cenę $69, a rozpoczęcie tego samego dnia jest w cenniku za $109. Najpierw idą polecenia tylko do odczytu, żaden niszczący krok nie rusza bez kopii zapasowej, a jeśli nie naprawimy, nie płacisz nic.

/ Pytania

Częste pytania

Co oznacza błąd 502 Bad Gateway?
Serwer, który odpowiedział, zwykle nginx albo CDN, działa, ale aplikacja albo serwer za nim nie przysłał poprawnej odpowiedzi. Usterka prawie zawsze leży za nginx, a nie w nim.
Czy 502 to moja wina, czy hostingu?
Na własnym VPS zwykle winny jest PHP-FPM albo aplikacja na tym serwerze. Jeśli strona z błędem 502 nosi nazwę CDN, to CDN nie dostał odpowiedzi od twojego serwera, więc najpierw sprawdź, czy serwer w ogóle odpowiada.
Dlaczego błąd 502 pojawia się i znika?
Najczęściej pod obciążeniem PHP-FPM kończą się procesy albo jakiś proces jest zabijany z braku pamięci i startuje od nowa. Zestaw godziny wpisów w logu błędów z ruchem na stronie, a zobaczysz, które z tych dwóch.
Ile kosztuje naprawa błędu 502?
U nas Ratowanie serwera za $69 za incydent albo $109 z rozpoczęciem tego samego dnia. Jeśli nie naprawimy, nie płacisz nic.
/ Źródła

Skąd pochodzi każde stwierdzenie

Sprawdzone ze źródłami dnia .

Inne poradniki