5045xx · Erro do servidor
HTTP 504 Gateway Timeout
O 504 Gateway Timeout indica que o proxy esperou pela resposta do servidor de origem além do tempo limite configurado.
O que significa
O proxy esperou tempo demais pela origem. A requisição era válida, mas o servidor falhou ao respondê-la.
Especificação: RFC 9110
Causas comuns
- Consulta ao banco de dados demorando mais que o timeout do proxy
- Integração externa lenta dentro do fluxo da requisição
- Processamento pesado feito de forma síncrona
- Timeout do proxy configurado abaixo do tempo real da operação
Como resolver
- Identifique a etapa lenta com rastreamento distribuído ou log de tempo
- Mova o processamento pesado para uma fila e responda 202 Accepted
- Otimize as consultas e adicione índices onde faltar
- Ajuste o timeout do proxy apenas como paliativo, nunca como solução
Exemplo de resposta
HTTP/1.1 504 Gateway Timeout
Content-Type: text/html
<html><head><title>504 Gateway Time-out</title></head></html>Perguntas frequentes
- Devo apenas aumentar o timeout?
- É paliativo. Aumentar o limite esconde o problema e segura conexões por mais tempo, o que agrava a sobrecarga. O caminho é reduzir o tempo da operação ou torná-la assíncrona.