Erro HTTP 502 Bad Gateway: O que Significa e Como Resolver

O 502 Bad Gateway indica que um servidor intermediário recebeu uma resposta inválida. Veja como diagnosticar e resolver.

Erro / SoluçãoTecnologiarede

O erro HTTP 502 Bad Gateway ocorre quando um servidor intermediário (proxy, load balancer ou CDN) recebe uma resposta inválida ou nenhuma resposta do servidor de origem.

Causas frequentes

Aplicação backend travada ou fora do ar
Timeout entre proxy (Nginx/Caddy) e o serviço (Node, Python, PHP-FPM etc.)
Configuração incorreta de upstream
Problemas de DNS ou firewall bloqueando a comunicação interna
Sobrecarga ou falta de recursos no servidor de origem

Do lado do usuário

Atualize a página (Ctrl+F5)
Limpe cache e cookies do navegador
Teste em outra rede ou dispositivo
Verifique o status do serviço (Twitter/X do provedor, status page)

Do lado do servidor (Nginx / Caddy)

Verifique os logs:

# Nginx
sudo tail -f /var/log/nginx/error.log

# Caddy
journalctl -u caddy -f

Confirme se o upstream está respondendo:

curl -I http://127.0.0.1:PORTA
# ou
ss -tlnp | grep PORTA

Aumente timeouts se necessário e reinicie o serviço de proxy após alterações.

tip · Em ambientes com Docker, confirme que a rede entre containers está correta e que o healthcheck do serviço está passando.

Quer aplicar isso ao seu contexto?

Se esse problema existe na sua operação, podemos analisar o cenário em um diagnóstico gratuito de 30 minutos.

solicitar diagnóstico gratuito →