HTTP 502 Bad Gateway (Gateway inválido)
Um gateway ou proxy recebeu uma resposta inválida do servidor de origem.
Ficha rápida
| Código | 502 |
|---|---|
| Nome oficial (em inglês) | Bad Gateway |
| Nome em português | Gateway inválido |
| Grupo | Erro do servidor (5xx) |
| Definido em | RFC 9110, Section 15.6.3 |
| Quem costuma gerar | O servidor, ou um gateway ou proxy no caminho, quando a falha está do lado do serviço. |
O que significa
Um gateway ou proxy (como um balanceador, um CDN ou um servidor de borda) recebeu uma resposta inválida do servidor de origem. Quem respondeu 502 está funcionando; o problema está no servidor por trás dele.
Quando o servidor devolve esse código
- Servidor de origem fora do ar ou reiniciando.
- Resposta malformada da aplicação para o proxy.
Problemas comuns
- A aplicação caiu ou travou.
- Proxy apontando para a porta ou o endereço errado.
- Sobrecarga que derruba a aplicação.
Como resolver
- Quem consome: aguarde e tente de novo.
- Quem mantém: verifique se a aplicação está no ar e se o proxy aponta para o destino certo.
- Consulte os logs do proxy e da aplicação.
Em automações e integrações
Um 502 em chamada de fluxo costuma ser passageiro, e a repetição automática ajuda. Se persistir, o problema está no serviço de destino ou no proxy dele.
Não confunda com outros códigos
Não confunda com 504: no 502 a resposta de origem foi inválida; no 504, não houve resposta a tempo.
Exemplo de resposta
HTTP/1.1 502 Bad Gateway
O exemplo é ilustrativo: o corpo e os cabeçalhos reais mudam de servidor para servidor. O código e o nome seguem o padrão HTTP.
Perguntas frequentes
502 e 504 são iguais?
Não. No 502, a resposta de origem foi inválida. No 504, não houve resposta a tempo.
O problema é do meu navegador?
Em geral, não. Está entre o proxy e o servidor de origem.