Erro 502 Bad Gateway: o que significa e como resolver

Resposta rápida

502 Bad Gateway é um erro HTTP de servidor. Ele aparece quando um gateway, proxy, CDN ou balanceador recebe uma resposta inválida do servidor para o qual encaminhou a requisição. O navegador conseguiu chegar a uma camada da infraestrutura, mas essa camada não obteve uma resposta válida da próxima.

Na maioria dos casos, o visitante não consegue corrigir a causa. Atualizar uma vez, testar outra rede e consultar o status ajudam a separar uma falha ampla de um problema local. Se o erro continuar para várias pessoas, a equipe do site precisa investigar a comunicação entre o intermediário e a origem.

O que o visitante pode fazer sem piorar o problema

Evite repetir ações que criam efeitos reais. Em pagamento, pedido, cadastro ou envio de formulário, uma tela 502 não garante que a operação falhou antes de ser processada. Confira o histórico ou a confirmação antes de tentar de novo.

• Atualize a página uma vez e anote o horário e o endereço exato que falhou.
• Abra outra página do mesmo serviço para saber se o erro atinge uma rota ou o site inteiro.
• Compare Wi-Fi com rede móvel. Se só uma rede falhar, teste sem VPN ou proxy pessoal conhecido.
• Consulte a página oficial de status e uma verificação externa antes de concluir que houve queda geral.
• Se houver transação envolvida, confirme o resultado na conta antes de reenviar a solicitação.

502 não é a mesma coisa que 503 ou 504

O 502 aponta para uma resposta inválida recebida por um intermediário. O 503 indica que o serviço está indisponível, muitas vezes por sobrecarga ou manutenção. O 504 indica que o gateway não recebeu uma resposta dentro do tempo esperado.

Esses códigos podem aparecer para sintomas parecidos, mas marcam pontos diferentes da falha. Trocar o limite de tempo não corrige automaticamente um 502 causado por processo parado, porta errada, conexão encerrada ou resposta HTTP malformada.

Checklist para quem administra o site

A documentação da Cloudflare consultada em 29 de agosto de 2026 orienta primeiro identificar se o 502 foi gerado pela própria rede intermediária ou pelo servidor de origem. A investigação precisa preservar horário, URL, centro de dados, identificador da requisição e resposta observada.

Na AWS, a documentação de Application Load Balancer lista como causas possíveis o recebimento de um reset TCP do destino ou uma resposta inesperada durante a conexão. Isso reforça que a análise precisa cruzar os registros do balanceador com os logs da aplicação e do servidor web.

• Confirme se o processo da aplicação está ativo e ouvindo na porta esperada pelo proxy ou balanceador.
• Teste a origem internamente e compare a resposta com a entregue pela CDN ou pelo proxy público.
• Cruze logs do gateway, servidor web e aplicação pelo mesmo horário e identificador de requisição.
• Verifique resets de conexão, respostas incompletas, cabeçalhos inválidos e encerramentos inesperados do processo.
• Confira saúde dos destinos, uso de CPU e memória, limite de conexões e reinicializações recentes.
• Valide firewall, regras de acesso e endereços permitidos entre o intermediário e a origem.
• Depois da correção, repita o teste por mais de uma rota e acompanhe a taxa de erros antes de encerrar o incidente.

Quando existe CDN ou proxy reverso

Uma resposta 502 na borda não prova que a CDN inteira caiu. O intermediário pode estar saudável e apenas não conseguir conversar corretamente com a origem daquele domínio. Também é possível que a origem gere o 502 e a CDN apenas repasse a resposta.

Compare o corpo da página de erro, os cabeçalhos e os registros do provedor, mas não exponha publicamente o endereço da origem para fazer o teste. A correção deve manter as regras de segurança e o acesso restrito planejados para a arquitetura.

Limites do diagnóstico externo

Um teste externo confirma o código recebido, o horário e a rota pública. Ele não enxerga automaticamente logs privados, processos internos, saúde de contêineres ou regras entre serviços. Por isso não dá para afirmar a causa exata apenas olhando a tela 502.

Se o erro aparece só para uma pessoa, ainda vale testar rede, VPN, DNS e proxy local. Se aparece de várias redes, a evidência de falha no serviço aumenta, mas a camada responsável só pode ser confirmada com dados da infraestrutura.

Próxima ação útil

Use o verificador de disponibilidade do Caiu ou Não? para registrar a resposta pública e compare com o diagnóstico web. Se você administra o domínio, leve horário, URL e código aos logs da CDN, do proxy e da aplicação. Se é visitante, acompanhe o status e evite repetir transações até a resposta normalizar.

Fontes consultadas

Os links abaixo servem para conferir conceitos, orientações oficiais e o critério editorial usado neste conteúdo.

• 502 Bad GatewayMDN Web Docs
• Erro 502 ou 504Cloudflare Docs
• Erros HTTP 5xx na CloudflareCloudflare Docs
• Diagnóstico de Application Load BalancerAmazon Web Services
• HTTP 502 no Amazon CloudFrontAmazon Web Services