HTTP 504 — Gateway Timeout

O servidor está atuando como um gateway e não pode obter uma resposta a tempo.

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 504 (Gateway Timeout) é 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 504, Gateway Timeout, HTTP error 504, status code 504, HTTP 504 meaning, fix HTTP 504, server error.