O que é o erro 502 Bad Gateway
O erro 502 Bad Gateway ocorre quando um servidor recebe uma resposta inválida de outro servidor ao tentar processar uma requisição.
Isso geralmente acontece quando há uma falha de comunicação entre servidores, APIs ou serviços intermediários.
Principais causas do erro 502
- servidor de aplicação fora do ar
- API não respondendo corretamente
- timeout entre servidores
- configuração incorreta de proxy ou gateway
- excesso de carga no servidor
- problemas com DNS
Esse erro é muito comum em ambientes com Apache, Nginx, Cloudflare e AWS.
Como resolver o erro 502 Bad Gateway
1. Verifique se o servidor está online
Confira se o servidor de aplicação ou API está funcionando corretamente.
2. Reinicie serviços do servidor
Reiniciar serviços como Apache, Nginx, PHP-FPM ou o backend pode resolver o problema.
3. Verifique logs do servidor
Os logs ajudam a identificar falhas de comunicação entre serviços.
4. Confira configurações de proxy ou gateway
Configurações incorretas em proxies reversos podem gerar erro 502.
Erro 502 em APIs e aplicações web
Em APIs, o erro 502 normalmente indica que o serviço backend não respondeu corretamente ao gateway.
Verifique:
- status da API
- tempo de resposta
- credenciais e autenticação
Erro 502 é diferente de 500, 503 e 504
- 500: erro interno do servidor
- 502: resposta inválida de outro servidor
- 503: serviço indisponível
- 504: tempo limite excedido
Cada código aponta para um tipo diferente de falha.
Veja também
Conclusão
O erro 502 Bad Gateway indica problemas de comunicação entre servidores e geralmente está relacionado a infraestrutura ou serviços externos.
Analisar logs e verificar a disponibilidade dos serviços é o melhor caminho para resolver o problema rapidamente.
Aviso: As soluções podem variar conforme o servidor, hospedagem ou arquitetura utilizada.