Como corrigir o erro 504 Gateway Timeout
Perguntas frequentes
Qual a diferença entre erro 504 e erro 502?
No 502 Bad Gateway o servidor de origem responde algo inválido ao gateway. No 504 Gateway Timeout a origem não responde dentro do prazo e o gateway desiste de esperar. O 504 é sempre um problema de tempo: algo demorou demais.
O erro 504 só aparece em algumas páginas. Por quê?
Essas páginas executam um processo mais pesado (importação, relatório, busca) que ultrapassa o tempo limite do gateway. Páginas leves respondem rápido e não estouram o timeout. Otimize a rota pesada ou aumente o tempo de execução.
Aumentar o timeout do Nginx resolve de vez o 504?
Resolve o sintoma, não a causa. Se o gargalo for uma consulta lenta ou um plugin travando, o processo continua pesado. Use o timeout maior para diagnosticar e ataque a causa real: o banco, o plugin ou o PHP-FPM.
O 504 veio do Cloudflare. O que muda?
O Cloudflare corta a conexão em cerca de 100 segundos quando a origem demora além disso e devolve o próprio 504. Verifique se o gargalo está no seu servidor: se a página responde direto no host mas dá 504 pelo Cloudflare, o tempo de origem está alto demais.
Como sei qual processo está estourando o tempo?
Leia o error_log do Nginx procurando "upstream timed out" para ver a rota, e ative o log de consultas lentas do MySQL. Juntos eles apontam se o gargalo é PHP, banco ou um plugin específico.
Reiniciar o PHP-FPM faz o 504 sumir?
Pode fazer sumir temporariamente, porque libera workers travados. Mas se a causa for uma página pesada ou uma query lenta, o erro volta na próxima vez que aquele processo rodar. Reiniciar é paliativo, não correção.














