Um erro 504 é normalmente exibido quando a conexão entre seu navegador e o servidor web é mantida aberta por muito tempo, fazendo com que um timeout HTTP ocorra.

Quando várias solicitações chegam simultaneamente, algumas solicitações podem precisar esperar na fila para serem atendidas. Assim, mesmo que o servidor possa estar processando pedidos, se cada um estiver demorando muito tempo para ser processado, um grande número de pedidos pode ser acumulado. Quando a fila fica muito grande e os processos esperam muito tempo, as solicitações mais antigas são desconsideradas pelo servidor, fazendo com que um erro de gateway 504 seja retornado.

Como a maioria das soluções de erros, o primeiro passo é descobrir qual é a causa raiz do erro.

Encontrando e resolvendo um erro Timeout do Gateway 504

Erros durante a importação

Caso o erro estiver ocorrendo durante uma importação, tente executar a importação diretamente no servidor usando WP-CLI ou um PHP local, ou um script Bash. Isto irá ignorar completamente a conexão HTTP, permitindo que você complete a importação sem um erro 504.

CDN de terceiros

Se o seu site utiliza um CDN de terceiros, além da integração do Kinsta Cloudflare, desative temporariamente ou ignore esse CDN.

Verifique o Upload Path

Se você estiver vendo um erro relacionado ao caminho do arquivo ao tentar carregar um arquivo (por exemplo, adicionar e carregar uma imagem no conteúdo), o caminho de carregamento pode estar incorreto. Isto é mais comum logo após a migração de um site. Dependendo da configuração em seu provedor de hospedagem web anterior, o caminho de upload pode ter sido personalizado. Isto pode ser visto na tabela wp_options ou no painel do WordPress (Configurações > Mídia > Carregando Arquivos).

No painel do WordPress, se você ver opções rotuladas como Armazenamento de uploads nesta pasta e caminho URL completo para arquivos, eles foram personalizados. Os dados correspondentes no banco de dados podem ser encontrados no site wp_options table nas opções upload_path e upload_url_path.

Você pode apagar qualquer coisa nesses campos (seja no painel do WordPress ou no banco de dados) para ajustá-los de volta aos seus padrões.

Tamanho do arquivo de uploads

Se você estiver vendo um erro relacionado ao tamanho do arquivo ao tentar fazer upload de um arquivo, verifique o tamanho do(s) arquivo(s) que você está tentando fazer upload. Alguns CDN limitam o tamanho dos arquivos que você pode fazer upload. Se você estiver usando um CDN de terceiros, verifique o tamanho máximo de upload em suas configurações de CDN e certifique-se de que seus uploads sejam menores que o máximo. Ou, caso o seu site exigir que o tamanho do arquivo seja tão grande, ajuste o tamanho máximo de upload no seu CDN (se possível).

Banco de dados corrompido

Ocasionalmente, um banco de dados corrompido pode ser a fonte de erros 504. Se você ver erros que indicam um banco de dados corrompido (por exemplo: “Uma ou mais tabelas do banco de dados não estão disponíveis”. O banco de dados pode precisar ser reparado” ao entrar no painel do WordPress) veja nosso guia sobre reparo de um banco de dados corrompido.

Plugins e temas

Embora não seja tão comum, às vezes um plugin ou tema pode ser a fonte de um erro 504. A melhor maneira de testar isso é desativar todos os plugins e mudar para um tema padrão. Se o problema for resolvido, reative os plugins um a um e reative seu tema até que o problema ocorra novamente. Uma vez que você tenha determinado qual plugin ou tema é a fonte, envie uma cópia do erro para o plugin ou desenvolvedor do tema para que eles possam ajudá-lo a resolver o problema.

Registro de erros

Verifique o error.log para seu site no MyKinsta (ou baixe via SFTP) para restringir a fonte do erro. Caso nada se destacar, pode ser útil habilitar o WP-DEBUG.

Tráfego e cache

Verifique o relatório de Visitantes na análise do MyKinsta para ver se o seu site está passando por um pico de tráfego e/ou um grande número de solicitações sem cache. Abrir uma conversa com nossa equipe de suporte pode ser útil neste caso, assim podemos ajudá-lo a determinar se as solicitações são legítimas e se mais recursos (como PHP Workers) podem ser necessários.

Aumente o número de PHP Workers

Em alguns casos, mais PHP Workers podem ser necessários. Se você não tem certeza, nossa equipe de suporte pode ajudá-lo a determinar se é necessário adicionar mais PHP Workers para o seu site.

Limitando o tráfego

Caso o seu site esteja passando por um pico de tráfego ou apenas mais tráfego em geral, aumentar os recursos não é uma opção. Uma alternativa para evitar que muitos pedidos cheguem ao servidor de uma só vez é implementar um sistema de fila como o Queue-it, Queue-Fair, ou Crowdhandler.