O que significa
Um gateway ou proxy recebeu uma resposta inválida do servidor upstream para o qual repassou a requisição.
Causas comuns
- O servidor da aplicação caiu ou não está escutando (porta ou socket errado)
- O upstream fechou a conexão ou enviou cabeçalhos malformados
- Reinício de processos PHP-FPM, Gunicorn ou Node
Como resolver
Se você é o cliente ou visitante
Tente de novo daqui a pouco; geralmente é temporário. Se persistir, o backend do site está fora do ar.
Se você mantém o site ou a API
Verifique se o processo upstream está rodando e escutando no endereço que o proxy usa, e leia o log de erros do proxy para ver o erro exato.
Resposta de exemplo
HTTP/1.1 502 Bad Gateway
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: text/html
Content-Length: 0 Especificação
Perguntas frequentes
› Como corrijo 502 Bad Gateway no nginx?
Verifique o upstream (o app está rodando, o endereço/socket do proxy_pass está correto) e o log de erros do nginx; reinicie o servidor da aplicação se ele caiu.
› 502 ou 504?
502: o upstream respondeu lixo ou fechou a conexão. 504: o upstream não respondeu a tempo.