WordPress / Nginx
502 Bad Gateway w Nginx
Sprawdź połączenie reverse proxy z aplikacją. Przyczyna zwykle jest w logu błędu i adresie upstream.
Środowisko i zakresNginx jako reverse proxy lub brama FastCGI. nginx.conf, port aplikacji i ścieżki logów zależą od instalacji.
Co może być przyczyną?
- Aplikacja lub PHP-FPM nie działa.
- proxy_pass albo fastcgi_pass wskazuje niewłaściwy adres lub socket.
- Upstream zamyka połączenie albo zwraca niepoprawną odpowiedź.
1. Odczytaj log Nginx
Szukaj wpisu z momentu żądania. Connection refused, Permission denied i premature close prowadzą do różnych napraw.
sudo tail -n 80 /var/log/nginx/error.log
sudo nginx -t2. Sprawdź usługę upstream
Dla aplikacji HTTP sprawdź jej rzeczywisty port z tej samej sieci, w której działa Nginx. Poniższy curl nie służy do testowania portu FastCGI PHP-FPM.
sudo ss -ltnp
curl -I --connect-timeout 5 http://127.0.0.1:8080/3. Jeśli to PHP-FPM albo Docker
Przy PHP-FPM sprawdź stan właściwej wersji usługi i prawa socketu. Gdy Nginx jest w kontenerze, jego 127.0.0.1 wskazuje ten kontener, a nie host ani inny kontener.
Jak naprawić problem?
- Popraw adres upstream albo uruchom naprawioną aplikację po analizie jej logów.
- Dopasuj dostęp użytkownika Nginx do socketu PHP-FPM bez nadawania praw wszystkim.
- Po zmianie Nginx wykonaj test, a potem reload: sudo nginx -t && sudo systemctl reload nginx. Dla instalacji kontenerowej użyj procedury tego projektu.
Jak potwierdzić naprawę?
Sprawdź stronę przez publiczny adres oraz typową operację aplikacji. W logu nie powinny pojawiać się kolejne 502 dla tych żądań.
curl -I https://example.com/Czego nie robić?
Nie zwiększaj losowo timeoutów i nie przełączaj PHP-FPM na publiczny port. Najpierw ustal, czy połączenie w ogóle powstaje.
Źródła i dokumentacja
Data publikacji: 24.09.2026.