DevToolPal
PL
5xx Błędy serwera

502 Bad Gateway

Błędna brama

Co to znaczy

Brama lub proxy otrzymały nieprawidłową odpowiedź od serwera upstream, do którego przekazały żądanie.

Typowe przyczyny

  • Serwer aplikacji uległ awarii lub nie nasłuchuje (zły port lub gniazdo)
  • Upstream zamknął połączenie lub wysłał błędne nagłówki
  • Restart procesu PHP-FPM, Gunicorn lub Node

Jak naprawić

Jako klient lub odwiedzający

Ponów za chwilę; zwykle to stan przejściowy. Jeśli trwa, backend strony nie działa.

Jako właściciel strony lub API

Sprawdź, czy proces upstream działa i nasłuchuje pod adresem używanym przez proxy, i przeczytaj log błędów proxy, aby poznać dokładny błąd upstream.

Przykładowa odpowiedź

HTTP/1.1
HTTP/1.1 502 Bad Gateway
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: text/html
Content-Length: 0

Specyfikacja

RFC 9110 §15.6.3

FAQ

› Jak naprawić 502 Bad Gateway w nginx?

Sprawdź upstream (czy aplikacja działa, poprawny adres/gniazdo w proxy_pass) i log błędów nginx; zrestartuj serwer aplikacji, jeśli uległ awarii.

› 502 czy 504?

502: upstream odpowiedział śmieciami lub zamknął połączenie. 504: upstream nie odpowiedział na czas.