5025xx · Erro do servidor
HTTP 502 Bad Gateway
O 502 Bad Gateway indica que um proxy ou load balancer recebeu uma resposta inválida do servidor de origem.
O que significa
Um proxy recebeu resposta inválida do servidor de origem. A requisição era válida, mas o servidor falhou ao respondê-la.
Quando usar
Aparece quando a aplicação atrás do nginx ou do load balancer caiu.
Especificação: RFC 9110
Causas comuns
- Aplicação atrás do Nginx caiu ou não subiu depois do deploy
- Contêiner reiniciando ou falhando no health check
- Porta ou endereço de upstream configurado errado
- Aplicação demorando tanto que o proxy encerrou a conexão
Como resolver
- Confirme se o processo da aplicação está rodando e escutando na porta esperada
- Confira o log do proxy: ele registra o motivo da recusa do upstream
- Valide a configuração de upstream, incluindo host e porta
- Verifique o health check do orquestrador quando houver contêineres
Exemplo de resposta
HTTP/1.1 502 Bad Gateway
Content-Type: text/html
<html><head><title>502 Bad Gateway</title></head></html>Perguntas frequentes
- 502 é problema meu ou do servidor?
- Do lado do servidor. O 502 aparece quando o proxy não conseguiu uma resposta válida da aplicação de origem — não há nada que o cliente possa mudar na requisição para evitá-lo.
- Qual a diferença entre 502 e 504?
- No 502 a origem respondeu algo inválido ou recusou a conexão. No 504 ela simplesmente não respondeu dentro do tempo limite do proxy.