HTTP 502 — Bad Gateway

O servidor recebeu uma resposta inválida do servidor upstream.

Por que isso acontece

Indisponibilidade temporária do backend ou manutenção.
Exceção não tratada na aplicação.
Dependência upstream (BD, cache, API) indisponível.

Como corrigir

Verifique os logs da aplicação e o rastreamento de erros.
Cheque a saúde das dependências (BD, cache, APIs).
Aplique degradação controlada e tentativas (retries) em incidentes.

HTTP 502 (Bad Gateway) é um código servidor. Abaixo estão o contexto e as recomendações para cenários de «server».

Erros do servidor refletem problemas no backend: indisponibilidade, exceções não tratadas ou dependências inacessíveis. Esta página retorna o status HTTP real para observação e alerta corretos de HTTP 5xx.

Implemente retries com backoff, instrumente o rastreamento de erros e monitore a saúde das dependências. Use esta página em testes e documentação.

Palavras‑chave: HTTP 502, Bad Gateway, HTTP error 502, status code 502, HTTP 502 meaning, fix HTTP 502, server error.