HTTP 504 Gateway Timeout (Tempo do gateway esgotado)
Um gateway ou proxy não recebeu resposta a tempo do servidor de origem.
Ficha rápida
| Código | 504 |
|---|---|
| Nome oficial (em inglês) | Gateway Timeout |
| Nome em português | Tempo do gateway esgotado |
| Grupo | Erro do servidor (5xx) |
| Definido em | RFC 9110, Section 15.6.5 |
| Quem costuma gerar | O servidor, ou um gateway ou proxy no caminho, quando a falha está do lado do serviço. |
O que significa
Um gateway ou proxy esperou a resposta do servidor de origem e o tempo acabou. O servidor por trás pode estar lento, sobrecarregado ou travado em uma operação demorada.
Quando o servidor devolve esse código
- Consulta ou processamento mais demorado que o limite do proxy.
- Servidor de origem sem responder.
Problemas comuns
- Operação pesada que passa do tempo limite do proxy ou do balanceador.
- Rede lenta entre o proxy e a origem.
- Servidor sobrecarregado.
Como resolver
- Quem mantém: otimize a operação lenta ou aumente o tempo limite com critério.
- Para tarefas longas, responda logo (202) e processe em segundo plano.
- Quem consome: tente de novo e, se persistir, avise o responsável.
Em automações e integrações
Se um fluxo chama uma operação demorada e recebe 504, veja se a API oferece um modo assíncrono, em que ela responde logo com 202 e você consulta o resultado depois.
Não confunda com outros códigos
Não confunda com 408 (o servidor esperou a requisição do cliente) nem com 502.
Exemplo de resposta
HTTP/1.1 504 Gateway Timeout
O exemplo é ilustrativo: o corpo e os cabeçalhos reais mudam de servidor para servidor. O código e o nome seguem o padrão HTTP.
Perguntas frequentes
O que o 202 tem a ver com o 504?
Em operações demoradas, devolver 202 (aceito) e processar depois evita o tempo limite do proxy.
504 é problema do meu lado?
Em geral, não. O proxy esperou a origem e ela não respondeu a tempo.