Como corrigir o erro 504 Gateway Timeout

Como corrigir o erro 504 Gateway Timeout

O erro 504 Gateway Timeout ocorre quando o servidor principal não recebe resposta de outro servidor necessário para concluir uma solicitação.

Na prática, isso significa que um dos servidores intermediários — chamado de upstream server — está com problemas, como sobrecarga, falha temporária ou simplesmente fora do ar.

Essas falhas impedem o servidor gateway de processar o pedido corretamente, resultando no erro 504. Ele pode ser causado tanto por erros momentâneos quanto por configurações mais complexas do servidor.

Por isso, corrigir um erro 504 pode envolver desde verificações simples no navegador até ajustes mais profundos no servidor.

Abaixo estão 11 maneiras de corrigir o erro 504 Gateway Timeout:

  1. Atualize a página. O problema pode ser temporário. Atualizar a página força o navegador a enviar uma nova solicitação ao servidor.
  2. Tente um navegador diferente. Assim, você descarta falhas causadas por configurações, cache ou extensões que possam interromper a conexão.
  3. Verifique as configurações do seu servidor proxy. Configurações de proxy incorretas ou sobrecarregadas podem atrasar a comunicação com o servidor, levando a tempos limite.
  4. Desative seu firewall. Um firewall muito restritivo pode bloquear solicitações ou atrasar respostas do servidor.
  5. Limpe o cache do DNS. Um cache DNS corrompido ou desatualizado pode direcionar pedidos para o lugar errado. Ao limpar o cache, o sistema busca novas informações do servidor.
  6. Verifique o log de erros do seu site. Ele pode revelar falhas específicas ou gargalos que estejam provocando o timeout.
  7. Verifique os plugins do seu site. Plugins com falhas ou mal otimizados podem aumentar o tempo de resposta e gerar o erro 504.
  8. Desative sua CDN. Se a rede de distribuição de conteúdo estiver sobrecarregada ou mal configurada, isso pode causar falhas de resposta.
  9. Verifique os recursos do seu servidor. Pouca memória, CPU ou largura de banda podem impedir o servidor de responder a tempo.
  10. Configure suas configurações do Apache ou NGINX. Parâmetros incorretos de timeout ou proxy podem gerar atrasos que resultam no erro 504.
  11. Entre em contato com o suporte do seu provedor de hospedagem. Se o problema for interno do servidor, o suporte pode verificar rotas de rede, carga do sistema ou falhas no data center.

Essas soluções cobrem desde ajustes simples no navegador até correções no servidor. Na maioria dos casos, uma dessas etapas resolve o erro 504 Gateway Timeout rapidamente.

A seguir, mostraremos como aplicar cada método — começando pelos testes mais básicos no lado do cliente e avançando para soluções mais técnicas no servidor.

1. Atualize a página

Atualizar a página é o primeiro e mais simples passo para tentar corrigir o erro 504 Gateway Timeout. Essa ação pode resolver falhas temporárias de conexão, especialmente se o problema for causado por uma sobrecarga momentânea do servidor.

Antes de atualizar, limpe o cache do navegador e os cookies para eliminar possíveis problemas que possam estar interferindo no carregamento. Para atualizar a página, clique no botão Atualizar do seu navegador. Outra opção é usar os atalhos do teclado: pressione Ctrl + R no Windows ou Command + R no macOS. 

No entanto, atualizar a página não resolverá o erro se o servidor ainda estiver enfrentando problemas. Nesses casos, será necessário seguir para outros métodos de correção do erro 504 Gateway Timeout.

Trocar de navegador pode ajudar a identificar se o erro 504 Gateway Timeout está relacionado ao navegador que você está usando. Problemas como software desatualizado, extensões de terceiros ou cache corrompido podem causar esse tipo de erro.

Experimente abrir outro navegador no seu dispositivo e acessar a mesma página. Como alternativa, use o modo anônimo no navegador atual.

Se a página carregar normalmente, o problema provavelmente está no cache, nas extensões ou nas configurações do seu navegador principal.

Caso a página ainda não carregue, isso pode indicar um problema mais generalizado, possivelmente no lado do servidor. Você pode verificar se o site está fora do ar para outras pessoas usando um serviço online como o Website Planet ou o Site24x7.

3. Verifique as configurações do seu servidor proxy

O servidor proxy atua como um intermediário entre o seu dispositivo e a internet, oferecendo benefícios de privacidade, como ocultar sua localização ou criptografar solicitações da web. No entanto, configurações incorretas podem dificultar a comunicação com os servidores e causar o erro 504 Gateway Timeout — embora isso seja relativamente raro.

Veja como verificar as configurações de proxy do seu computador:

Windows 11

  1. Vá para Configurações → Rede e Internet → Proxy. Você encontrará opções como Detectar configurações automaticamente e Usar um servidor proxy.
  1. Se a opção Usar um servidor proxy estiver ativada, certifique-se de que os detalhes do endereço e da porta estejam configurados corretamente para sua rede.
  2. Como alternativa, desative essa opção e tente acessar o site novamente.

macOS Sonoma

  1. Clique no ícone da Apple e selecione Ajustes do sistema → Rede.
  2. Ao lado da rede conectada, clique em Detalhes.
  3. Selecione a aba Proxies. Desative todas as opções de proxy desativando cada configuração relacionada a proxy.

O processo é semelhante em outras versões recentes do macOS, mudando apenas o nome do menu para Preferências do Sistema nas versões anteriores ao Ventura.

Embora muitos computadores e redes não usem proxy por padrão, alguns navegadores mantêm configurações próprias de proxy. Por isso, também é importante verificar essas opções diretamente no navegador.

Importante! Lembre-se de que alterar as configurações de rede pode afetar toda a sua conexão com a internet e causar outros problemas. Faça mudanças com atenção e apenas se tiver certeza do que está fazendo.

4. Desative o firewall

O firewall é uma ferramenta essencial para proteger o computador contra acessos não autorizados e ameaças cibernéticas. No entanto, uma configuração incorreta pode acabar bloqueando solicitações legítimas da rede e causar o erro 504 Gateway Timeout.

Siga estas etapas para desativar temporariamente seu firewall:

Windows 11

  1. Clique no menu Iniciar e selecione Configurações.
  2. Vá para Privacidade e segurança → Segurança do Windows → Firewall e proteção de rede.
  1. Escolha sua rede ativa no momento (por exemplo, rede privada, pública ou de domínio) e desative o Firewall do Microsoft Defender.

macOS Sonoma

  1. Abra Ajustes do sistema → Rede.
  2. Role para baixo e selecione Firewall.
  3. Clique no botão para desativar o firewall.

Após desativar o firewall, tente acessar novamente o site para verificar se as configurações incorretas estavam causando o erro 504.

Importante! Desativar o firewall deve ser apenas uma medida temporária de diagnóstico. Manter o firewall desligado por muito tempo aumenta consideravelmente a vulnerabilidade do sistema a ataques e invasões.

5. Limpe o cache DNS

Limpar o cache DNS pode ajudar a resolver problemas de conectividade de rede, incluindo o erro 504 Gateway Timeout. Esse processo apaga informações DNS antigas ou corrompidas que podem impedir o seu dispositivo de se conectar corretamente aos sites.

Para corrigir problemas de DNS do lado do cliente, tente limpar o cache DNS no seu sistema operacional:

Windows 11

  1. Procure por cmd na barra de tarefas e clique com o botão direito do mouse em Prompt de Comando → Executar como administrador.
  2. Digite ipconfig /flushdns e pressione Enter.
  3. Uma mensagem confirmará que o cache do resolvedor DNS foi limpo com sucesso.

macOS Sonoma

  1. Abra o Terminal em Aplicativos → Utilitários.
  2. Digite sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder e pressione Enter.
  3. Digite sua senha de administrador, se solicitado.

Google Chrome

O Google Chrome mantém um cache DNS separado. Para limpá-lo:

  1. Abra o Chrome, digite chrome://net-internals/#dns na barra de endereços e pressione Enter.
  2. Clique no botão Limpar cache do host para limpar o cache DNS do Chrome.

Se o seu site foi recentemente movido para outro endereço IP ou servidor, pode ser necessário aguardar até 48 horas para a propagação do DNS, período em que os provedores de internet atualizam seus registros.

Você pode usar ferramentas como whatsmydns.net para verificar se a propagação foi concluída.

Se o problema de DNS persistir, tente mudar para um servidor DNS público, como o DNS Público do Google Cloudflare (1.1.1.1) ou Quad9, que costumam oferecer uma resolução de DNS mais rápida e estável.

6. Verifique o log de erros do seu site

Uma das causas do erro 504 Gateway Timeout pode ser um conjunto de falhas no código devido a atualizações recentes ou plugins de terceiros. Verificar o log de erros do site ajuda a identificar esse tipo de problema. Esses registros armazenam mensagens sobre falhas que ocorrem no site, incluindo as que resultam no erro 504.

Os clientes de hospedagem da Hostinger podem utilizar o recurso de registro de erros PHP através do hPanel. Veja como:

  1. Faça login no hPanel e navegue até Avançado → Configuração PHP.
  2. Na guia Opções PHP, marque a caixa logErrors.
  1. Role para baixo e clique em Salvar para ativar o registro de erros PHP.

Se o seu provedor de hospedagem não oferece o registro de erros PHP por padrão e você usa WordPress, é possível ativar o modo de depuração no seu site seguindo estas etapas:

  1. Abra o Gerenciador de Arquivos e localize o arquivo wp-config.php.
  2. Adicione as linhas abaixo ao arquivo logo antes da linha /* That’s all, stop editing! Happy publishing. */:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
  1. Salve as alterações antes de sair.

Veja o que cada variável faz:

  • WP_DEBUG. Ativa o modo de depuração do WordPress.
  • WP_DEBUG_LOG. Salva todos os erros PHP no arquivo wp-content/debug.log.
  • WP_DEBUG_DISPLAY. Decide se as mensagens de depuração serão exibidas nas páginas HTML. Definir como false oculta os erros no site, mas ainda os registra no arquivo.

Depois de ativar essas configurações, você pode acessar os arquivos de log do WordPress via SFTP. Eles geralmente estão na pasta logs dentro do diretório raiz do servidor.

Além disso, vale também conferir os logs do servidor, que podem ajudar na investigação do problema. Veja onde encontrá-los, de acordo com o tipo de servidor:

  • Apache. O log de erros geralmente é encontrado em /var/log/apache2/error.log/.
  • NGINX. Para servidores NGINX, verifique /var/log/nginx/error.log/.

7. Verifique os plugins do seu site

Em alguns casos, os plugins do WordPress podem, por vezes, levar a um erro 504 Gateway Timeout. Isso geralmente acontece quando um plugin aumenta demais a carga do servidor ou entra em conflito com outros componentes do site.

Veja como verificar se um plugin é o responsável pelo erro:

  1. Acesse o painel de administração do WordPress e vá para Plugins → Plugins instalados.
  2. Desative todos os plugins instalados. Se o seu site voltar a funcionar depois disso, é provável que um plugin esteja causando o problema.
  1. Em seguida, reative os plugins um por um, testando o site a cada ativação. Se o erro 504 reaparecer, você saberá que o último plugin reativado será o culpado.
  2. Nesse caso, tente atualizá-lo, buscar uma alternativa compatível ou entrar em contato com o suporte do plugin.

Se você não conseguir acessar o painel do WordPress, entre no Gerenciador de Arquivos da sua hospedagem ou use um cliente FTP. Navegue até o diretório wp-content e renomeie a pasta plugins — por exemplo, para plugins_backup. Isso desativará todos os plugins, permitindo verificar se o site volta a funcionar.

Depois de confirmar que o problema vem de um plugin, renomeie novamente a pasta para plugins e desative cada um individualmente até encontrar o causador.

Se desativar os plugins não resolver o erro 504, o problema pode estar no tema do WordPress. Nesse caso, altere para um tema padrão, como o Twenty Twenty-Four, e verifique se o site volta ao normal.

8. Desative seu CDN

Uma rede de distribuição de conteúdo (CDN) melhora o desempenho do site ao acelerar a entrega de conteúdo e oferecer proteção contra ataques DDoS. No entanto, em alguns casos, ela também pode causar o erro 504 Gateway Timeout.

Desativar temporariamente a CDN do seu site pode ajudar a identificar se ela está relacionada ao problema. Se você é cliente da Hostinger e possui um plano Business ou superior, siga estas etapas para desativar a CDN integrada:

  1. Navegue até o painel hPanel. Em seguida, vá para Desempenho → CDN.
  2. Na seção Status da CDN, clique em Desativar.
  1. Verifique seu site para ver se o problema foi resolvido.

Se, ao desativar a CDN, o site voltar a funcionar, mantenha-a desativada temporariamente e entre em contato com o suporte da Hostinger para obter ajuda na correção da falha relacionada à CDN.

Caso você utilize uma CDN externa, como Cloudflare ou outra provedora, verifique primeiro o status do sistema no site do serviço — pode haver instabilidades conhecidas. A maioria das CDNs permite pausar ou desativar o serviço diretamente no painel do provedor, normalmente em uma opção chamada Pausar ou Desativar CDN.

Lembre-se de que desativar uma CDN pode envolver mudanças no DNS, o que requer algum tempo para propagação completa. Após esse processo, acesse novamente o site para confirmar se o erro 504 foi corrigido.

9. Verifique os recursos do servidor

Quando o erro 504 Gateway Timeout aparece, uma das causas mais comuns é a sobrecarga do servidor. Cada provedor de hospedagem disponibiliza uma quantidade específica de recursos para garantir o bom desempenho do site — mas, em momentos de alto tráfego ou uso intenso, esses limites podem ser ultrapassados.

Se você usa a Hostinger, é possível verificar os recursos disponíveis acessando Plano de hospedagem → Uso de recursos no hPanel. Preste atenção especialmente ao uso de CPU e memória (RAM). Valores muito altos indicam que o servidor está sobrecarregado e com dificuldade para processar as solicitações.

Ao perceber uso elevado de recursos, tente reduzir o tráfego do site ou otimizar o desempenho, por exemplo, otimizando imagens, ativando cache ou limitando processos automáticos. Se o seu site WordPress já atingiu o limite do plano atual, considere atualizar o seu plano.

Podem ocorrer tempos limite do servidor se os scripts PHP excederem o tempo de execução definido pelo servidor. Estender o limite máximo de tempo de execução pode evitar esses tempos limite.

Se você usa a Hostinger, pode aumentar o valor do tempo máximo de execução do WordPress através do hPanel:

  1. No painel do hPanel, navegue até Avançado → Configuração PHP.
  2. Na guia Opções PHP, localize o campo maxExecutionTime, cuja configuração padrão é 30 segundos.
  3. Aumente esse valor para 60 segundos e clique em Salvar. Se os problemas persistirem, considere aumentá-lo ainda mais para 120 ou 180 segundos.

Importante! Evite definir o valor do tempo máximo de execução como 0, pois isso permite que os scripts PHP sejam executados indefinidamente, consumindo excessivamente os recursos do servidor.

Também é possível ajustar esse limite diretamente no arquivo .htaccess do seu site WordPress. Basta adicionar o seguinte trecho:

php_value max_execution_time 60

Altere o número conforme necessário para o seu caso. Isso ajuda a evitar falhas de timeout causadas por scripts demorados.

10. Configure suas configurações do Apache e NGINX

Para sites em hospedagem VPS, ajustar as configurações do Apache e do NGINX pode ajudar a controlar o tempo limite do servidor e corrigir o erro 504 Gateway Timeout. Veja como alterar as configurações nos servidores Apache e NGINX:

Apache

  1. Localize o arquivo de configuração do Apache, normalmente chamado httpd.conf ou apache2.conf, e abra-o com um editor de texto.
  2. Modifique a diretiva Timeout para um valor mais alto. Por exemplo, altere o padrão de 60 segundos para 600 segundos com:
Timeout 600
  1. Salve as alterações e feche o editor.
  2. Em seguida, edite o arquivo php.ini.
  3. Aumente a diretiva max_execution_time. O valor padrão é normalmente 30 segundos. Aumente-o para 300 segundos com:
max_execution_time = 300
  1. Salve as alterações e reinicie o Apache:
sudo service apache2 restart.

NGINX

  1. Encontre o arquivo de configuração do NGINX, geralmente localizado em /etc/nginx/nginx.conf.
  2. Para sites executados no NGINX + FastCGI Process Manager (PHP-FPM) ou que usam o NGINX como proxy reverso para o Apache, ajuste os seguintes valores:
proxy_connect_timeout 600;
proxy_send_timeout 600;
proxy_read_timeout 600;
send_timeout 600;
fastcgi_read_timeout 300;
  1. Recarregue o servidor NGINX para implementar as alterações.
sudo service nginx reload
  1. Edite o arquivo de configuração do pool PHP-FPM localizado em /etc/php/[versão]/fpm/pool.d/www.conf. Substitua [versão] pela sua versão do PHP.
  2. Defina request_terminate_timeout = 300 para aumentar o limite.
  3. No arquivo php.ini, defina max_execution_time = 300.
  4. Recarregue o PHP-FPM e o NGINX para aplicar as alterações.
sudo service php[versão]-fpm reload && sudo service nginx reload

11. Entre em contato com o suporte da sua hospedagem

Se você já tentou todas as soluções anteriores e o erro 504 Gateway Timeout ainda persiste, o melhor a fazer é entrar em contato com o suporte técnico da sua hospedagem.

Ao pedir ajuda, descreva o problema com o máximo de detalhes possível — inclua o URL do site, a mensagem de erro exibida e um resumo das ações que você já realizou para tentar resolver o problema. Essas informações ajudam a equipe de suporte a diagnosticar a causa mais rapidamente.

Se você é cliente Hostinger, pode obter ajuda imediata com o Kodee, nosso assistente de IA. Basta clicar no botão Pergunte ao Kodee, no canto inferior direito do hPanel, digitar o problema e informar qual site está apresentando o erro. O Kodee irá analisar a situação e orientar sobre os próximos passos para corrigir o erro 504.

Se precisar de mais ajuda, a equipe de Sucesso do Cliente da Hostinger também está disponível 24 horas por dia, 7 dias por semana, em diversos idiomas (incluindo português do Brasil).

O que causa o erro 504 Gateway Timeout?

O erro 504 Gateway Timeout ocorre quando um servidor demora muito para responder, impedindo o carregamento de uma página da web. Alguns gatilhos comuns incluem:

  • Problemas de conectividade. Falhas na rede ou nos equipamentos de conexão podem gerar instabilidades temporárias, afetando a comunicação entre navegadores, dispositivos e sites.
  • Problemas com o servidor proxy. Erros no proxy podem interromper o caminho de comunicação entre o servidor do site e o servidor intermediário (upstream server), resultando em tempo limite de resposta.
  • Problemas de firewall. Firewalls configurados de forma incorreta — especialmente aqueles com sistemas de proteção contra DDoS — podem bloquear solicitações legítimas. Isso também pode ocorrer por restrições de certos provedores de internet ou serviços de CDN, como o Cloudflare.
  • Problemas de DNS e domínios não resolvidos. Ocorrem quando os servidores DNS não conseguem traduzir o nome de domínio para o endereço IP correto. As causas incluem configurações incorretas, cache DNS desatualizado ou mudanças recentes de IP.
  • Problemas de conectividade do servidor. Problemas de rede ou hardware entre diferentes servidores podem gerar o erro 504, dificultando a comunicação entre eles.
  • Problemas no servidor upstream. Se o servidor upstream estiver inativo ou não responder, isso pode levar diretamente a um erro 504.
  • Sobrecarga do servidor web. Quando o servidor recebe mais solicitações do que consegue processar ou tem poucos recursos disponíveis, ele pode demorar a responder ou até parar completamente.
  • PHP workers limitados. Sites com poucos trabalhadores PHP (PHP workers) podem enfrentar lentidão para processar solicitações simultâneas, resultando em atrasos e timeouts.

Para evitar o erro 504 Gateway Timeout, é importante monitorar regularmente a carga do servidor, otimizar os recursos do site e manter uma rotina de manutenção preventiva.

Com servidores bem configurados e uma entrega de conteúdo eficiente, as chances de enfrentar esse tipo de erro diminuem significativamente.

Variações do erro 504 Gateway Timeout

O erro 504 Gateway Timeout pode se manifestar de várias formas diferentes, dependendo do navegador, da configuração do servidor e do sistema operacional.

Estas são algumas variações comuns do erro 504 que você pode encontrar:

  • 504 Gateway Timeout. A mensagem de erro 504 padrão.
  • Erro HTTP 504. Destaca-o como um código de status HTTP.
  • Erro do servidor – 504. Enfatiza que o problema se origina no servidor.
  • Erro de tempo limite do gateway. Indica diretamente um tempo limite no gateway do servidor.
  • 504 Tempo limite do gateway NGINX / NGINX 504 Tempo limite do gateway. Específico para servidores NGINX, indicando um tempo limite do gateway.
  • Erro 504 / Erro HTTP 504 / Erro HTTP 504 — Tempo limite do gateway. Diferentes expressões do erro, com foco na falha da solicitação HTTP.
  • Esta página não está funcionando — O domínio demorou muito para responder / 504 Tempo limite do gateway — O servidor não respondeu a tempo. Uma frase mais amigável explicando que houve um atraso na resposta.
  • A solicitação da página foi cancelada porque demorou muito para ser concluída. Indica um tempo limite no processamento da solicitação da página.
  • Visitantes do site: Houve um problema ao atender sua solicitação. Tente novamente em alguns minutos. Sugere que os visitantes do site acessem a página mais tarde devido a um atraso no atendimento da solicitação.
  • Proprietários do site: Ocorreu um tempo limite do gateway. Você deve consultar o seu log de erros para obter mais informações. Recomenda-se que o proprietário do site verifique o log de erros para obter mais detalhes.

Como o erro 504 Gateway Timeout afeta o SEO

O erro 504 Gateway Timeout pode prejudicar o SEO do seu site, especialmente se acontecer com frequência ou por longos períodos. Isso acontece porque mecanismos de busca como o Google usam os códigos de status HTTP para avaliar a saúde e a disponibilidade de um site.

Quando um site retorna o código 504 repetidamente, o Google pode interpretá-lo como instável ou não confiável, o que pode levar a uma queda no ranking dos resultados de pesquisa. Para reduzir os impactos do erro 504 no SEO, siga estas boas práticas:

  • Resolva o problema imediatamente. Quanto mais rápido o erro for corrigido, menor será o impacto no ranqueamento. Monitore o desempenho do servidor e aja imediatamente assim que o problema for detectado.
  • Comunique-se com os usuários. Use as redes sociais ou outros canais de comunicação para informar seu público sobre a instabilidade e as medidas que estão sendo tomadas para resolvê-la.
  • Crie uma página de erro temporária. Configure uma página informativa que explique que o site está passando por manutenção ou enfrentando um problema técnico. Isso mostra transparência e evita que os visitantes encontrem apenas a mensagem de erro.
  • Mantenha backups regulares do site. Ter cópias de segurança atualizadas permite restaurar o site rapidamente caso o erro 504 persista, reduzindo o tempo de inatividade.
  • Use ferramentas de monitoramento de SEO. Ferramentas como Google Search Console, Ahrefs ou Semrush ajudam a detectar falhas que possam afetar a visibilidade do site, permitindo uma resposta mais rápida e eficiente.

Qual a diferença entre o erro 504 e o erro 502?

Além do 504 Gateway Timeout, outros erros comuns na faixa 500 incluem o 502 Bad Gateway e o 503 Service Unavailable. Esses códigos indicam falhas no lado do servidor ao processar solicitações, mas cada um tem uma causa específica e exige um tipo diferente de correção.

O erro 504 Gateway Timeout compartilha algumas semelhanças com o erro 502 Bad Gateway, pois ambos indicam problemas com a comunicação do servidor. A principal diferença é que um erro 504 ocorre quando há um atraso na resposta do servidor, enquanto um erro 502 ocorre quando um servidor recebe uma resposta inválida de outro servidor.

É fundamental corrigir rapidamente qualquer mensagem de erro para manter seu site funcionando perfeitamente e proteger seu SEO. Confira nosso guia com a lista completa de códigos de status HTTP para se antecipar aos problemas.

Author
O autor

Bruno Santana

Jornalista formado pela Universidade Federal da Bahia e Especialista em Marketing de Conteúdo na Hostinger, onde atuo na criação e otimização de artigos úteis, envolventes e criativos em áreas como desenvolvimento web e, marketing. Além disso, sou colaborador eventual do site MacMagazine e da editoria de cultura do Jornal A Tarde, fascinado por arte, culinária e tecnologia.