O que significa
Um gateway ou proxy não recebeu a tempo a resposta do servidor upstream.
Causas comuns
- Consultas lentas ao banco ou chamadas lentas a APIs externas
- Timeout do proxy menor que o tempo de processamento
- Servidor upstream inacessível por problemas de rede
Como resolver
Se você é o cliente ou visitante
Tente de novo mais tarde; para operações longas, veja se a API oferece processamento assíncrono.
Se você mantém o site ou a API
Acelere o caminho lento ou mova-o para um job em segundo plano; aumente os timeouts do proxy (proxy_read_timeout) só até valores realistas.
Resposta de exemplo
HTTP/1.1
HTTP/1.1 504 Gateway Timeout
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Length: 0Especificação
Perguntas frequentes
› Como corrijo 504 Gateway Timeout no nginx?
Descubra por que o upstream está lento; se requisições longas forem esperadas, aumente proxy_read_timeout e o timeout do servidor da aplicação juntos.
› Quem retorna o 504, meu app ou o proxy?
O proxy, balanceador ou CDN na frente do seu app, depois de esperar demais por ele.