Você carregou uma página e apareceu 502 Bad Gateway. A versão curta: um servidor pediu uma resposta a outro e recebeu algo inválido. É um erro do lado do servidor: se você só está visitando, não é sua culpa; se administra o site, é sinal de que seu backend está mal.
O que significa 502 Bad Gateway
Sites modernos raramente falam direto com o backend. A requisição passa por uma cadeia — CDN, balanceador, proxy reverso (como Nginx) — antes de chegar ao servidor de aplicação. Quando um desses servidores intermediários (o "gateway") encaminha sua requisição e recebe uma resposta inválida ou vazia, retorna um 502. É um código 5xx: erro do servidor.
Causas comuns
| Causa | O que acontece |
|---|---|
| Upstream fora | A app backend caiu ou nunca subiu |
| Backend sobrecarregado | Tráfego demais; não responde a tempo |
| Proxy mal configurado | Nginx/HAProxy apontando para host/porta errados |
| Processo caiu | PHP-FPM, Node ou o worker morreu no meio da requisição |
| Firewall / DNS | O proxy não alcança a origem |
Como corrigir — como visitante
- Recarregue a página (muitos 502 são momentâneos).
- Espere alguns minutos e tente de novo.
- Limpe o cache ou teste em janela privada / outra rede.
Como corrigir — como desenvolvedor
- A origem está no ar? Confirme que o processo está rodando.
- Revise a config do proxy (host/porta upstream corretos).
- Leia os logs do backend — o 502 quase sempre tem um crash ou timeout associado.
- Cheque recursos (OOM, pool de conexões esgotado).
- Verifique rede: firewall, security groups, DNS entre proxy e origem.
Como pegar o próximo antes dos seus usuários
O pior de um 502 é descobrir por um cliente irritado. O Nurbak Watch checa seus endpoints de várias regiões e rastreia códigos de status e taxas de erro por rota — um spike de 502 te avisa por Slack, email ou WhatsApp assim que começa.