Um erro 504 geralmente é exibido quando a conexão entre o seu navegador e o servidor da web fica aberta por mais de 180 segundos, causando um timeout HTTP.

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.

Assim como na solução de outros erros, o primeiro passo para solucionar o erro é descobrir a causa raiz do problema.

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.