502 Bad Gateway indica che un server che funge da gateway o da proxy ha ricevuto una risposta non valida dal server a monte che ha contattato per soddisfare la richiesta. Il proxy in sé funziona; il problema sta dietro di esso.
Nelle configurazioni tipiche, il proxy è nginx, Apache, un load balancer o una CDN, e il server a monte è un application server come PHP-FPM, Node.js, Gunicorn o un container. Per “risposta non valida” si intende una connessione rifiutata o interrotta, un crash a metà risposta, intestazioni malformate o intestazioni più grandi dei buffer del proxy (nginx registra “upstream sent too big header”).
Su Cloudflare, i problemi del server di origine producono di solito codici più specifici come 520, 521 o 522. Un semplice 502 visto attraverso Cloudflare può provenire dal server di origine stesso oppure da un problema all’interno della rete di Cloudflare.
Esempio di risposta
HTTP/1.1 502 Bad Gateway
Date: Fri, 06 Nov 2026 10:15:32 GMT
Server: nginx
Content-Type: text/html
Content-Length: 142
Connection: keep-alive
<html>
<head><title>502 Bad Gateway</title></head>
<body>
<center><h1>502 Bad Gateway</h1></center>
<hr><center>nginx</center>
</body>
</html>SEO e verifica dei redirect
Come per gli altri errori 5xx, brevi periodi di 502 rallentano la scansione ma non rimuovono le pagine, mentre i 502 persistenti portano alla deindicizzazione. I 502 sono spesso intermittenti (un worker che si riavvia, un pool che si satura), quindi verifica un URL più volte oppure usa la Verifica redirect in blocco per vedere quanto spesso fallisce.
Cause comuni e casi d’uso
- L’application server (PHP-FPM, Node.js, Gunicorn) non è attivo, si sta riavviando o è andato in crash.
- Il proxy punta all’indirizzo, alla porta o al socket sbagliati del server a monte.
- Le intestazioni di risposta del server a monte superano i buffer del proxy (
proxy_buffer_sizeofastcgi_buffer_sizein nginx). - Un firewall o un security group impedisce al proxy di raggiungere il backend.