Erro 504 Gateway Timeout no WordPress: como corrigir

Tipo Erro HTTP

Nome do erro Erro 504 Gateway Timeout EN: 504 Gateway Timeout

Severidade Crítico

Descrição O erro 504 Gateway Timeout é um código HTTP que indica que um servidor intermediário (proxy ou gateway) esperou demais pela resposta do servidor de origem e desistiu. No WordPress, costuma vir de PHP-FPM travado, consulta de banco lenta ou timeout curto no Nginx.

O que é o erro 504 no WordPress?

O 504 Gateway Timeout é um código de status HTTP em que um servidor agindo como gateway (Nginx na frente do PHP, ou o Cloudflare na frente do seu host) não recebeu a resposta do servidor de origem dentro do prazo e encerrou a conexão. Diferente do 502, em que a origem responde algo inválido, no 504 ela simplesmente não responde a tempo. No WordPress, o gargalo quase sempre está no PHP-FPM ou no MySQL demorando para concluir a requisição.

Como identificar

Mensagem “504 Gateway Timeout” ou “nginx/x.x.x 504 Gateway Time-out” no navegador.
O erro aparece em páginas pesadas (importações, relatórios do WooCommerce, busca) e some em páginas leves.
O site cai sob carga ou em horários de pico e volta sozinho quando o tráfego diminui.
No error_log do Nginx aparece “upstream timed out (110: Connection timed out) while reading response header from upstream”.

Antes de começar: Aumentar timeouts trata o sintoma, não a causa. Use os valores maiores para diagnosticar e volte a um limite saudável depois de resolver o gargalo real, para o servidor não acumular processos travados.

Como prevenir

Mantenha um plugin de cache de página ativo para reduzir o tempo de processamento sob carga
Monitore consultas MySQL lentas e mantenha índices e a tabela wp_options enxutos
Rode tarefas pesadas (backup, importação) via WP-CLI ou cron, fora do ciclo de requisição web

Causa

PHP-FPM com worker travado ou esgotado, deixando a requisição sem resposta dentro do prazo do gateway.
Consulta MySQL lenta (tabela sem índice, autoload inchado) que estoura o tempo de execução do PHP.
Diretiva fastcgi_read_timeout do Nginx baixa demais para o tempo real de processamento da página.
Plugin de backup, importação ou crawler rodando em processo longo que ultrapassa o limite do upstream.
Cloudflare como proxy cortando a conexão em 100 segundos quando a origem demora além disso.

Como resolver

Identifique a página que estoura o tempo: no error_log do Nginx, localize a linha "upstream timed out" e veja qual rota disparou o timeout. Isso separa um problema pontual (uma página pesada) de um gargalo geral do servidor.
Aumente o tempo de leitura do upstream no Nginx: no bloco do PHP-FPM do site, eleve o fastcgi_read_timeout e o proxy_read_timeout para 300s e recarregue o Nginx.
```
fastcgi_read_timeout 300;
proxy_read_timeout 300;
sudo nginx -t && sudo systemctl reload nginx
```
Aumente o tempo de execução do PHP: no php.ini do PHP-FPM, suba o max_execution_time e o request_terminate_timeout para acompanhar o novo limite do Nginx, e reinicie o serviço.
```
max_execution_time = 300
request_terminate_timeout = 300
sudo systemctl restart php8.2-fpm
```
Desative plugins para isolar o gargalo: via FTP, renomeie a pasta wp-content/plugins para testar se um plugin de backup, importação ou cache mal configurado está prolongando a requisição além do limite.
Otimize o banco de dados: limpe a tabela wp_options de entradas autoload inchadas e revise consultas lentas. Uma query sem índice é a causa silenciosa mais comum de 504 sob carga.

NGINX

# /etc/nginx/conf.d/seusite.conf - eleva o tempo de espera pelo PHP-FPM
location ~ .php$ {
    fastcgi_pass   unix:/run/php/php8.2-fpm.sock;
    fastcgi_index  index.php;
    include        fastcgi_params;
    # tempo que o Nginx espera o PHP-FPM responder antes de cortar com 504
    fastcgi_read_timeout    300;
    fastcgi_send_timeout    300;
    fastcgi_connect_timeout 60;
}

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.

Crítico

Como corrigir o erro 500 Internal Server Error

O erro 500 Internal Server Error é um código HTTP genérico que indica que algo falhou no servidor sem dizer o quê. No WordPress, costuma vir de .htaccess corrompido, limite de memória PHP esgotado, um plugin ou tema com erro fatal, ou permissões de arquivo erradas.

Crítico

Como corrigir o erro 503 Service Unavailable

O erro 503 Service Unavailable é um código HTTP que indica que o servidor está temporariamente incapaz de atender à requisição. No WordPress, costuma aparecer quando uma atualização trava o site no arquivo .maintenance, quando o servidor está sobrecarregado ou quando um plugin/tema consome recursos demais.

Grave

Como corrigir o erro 404 Not Found no WordPress

O erro 404 Not Found é um código HTTP que indica que o servidor respondeu, mas não encontrou nenhum conteúdo na URL pedida. No WordPress, costuma surgir quando os permalinks quebram após uma migração, quando o .htaccess perde as regras de rewrite ou quando um post/página foi removido ou teve o slug alterado.

Grave

Como corrigir o erro 429 Too Many Requests

O erro 429 Too Many Requests é um código HTTP que indica que o cliente enviou requisições demais em pouco tempo e o servidor aplicou rate limiting. No WordPress, costuma vir de um plugin de segurança, do limite do host ou de bots martelando o wp-login.php.

Grave

Como corrigir erro 524 A Timeout Occurred (Cloudflare)

O erro 524 A Timeout Occurred é um código do Cloudflare que indica que a origem aceitou a conexão, mas não devolveu a resposta dentro do limite de 100 segundos. No WordPress, costuma vir de processos longos como importações, relatórios pesados ou consultas de banco lentas.

Atenção

Como corrigir o erro 408 Request Timeout

O erro 408 no WordPress é o código HTTP que o servidor envia quando fecha a conexão porque o navegador demorou tempo demais para enviar a requisição completa. Costuma surgir em conexões lentas, uploads grandes ou quando uma aba fica parada aguardando o envio dos dados.

Setores

Extensões

Integrações

Como corrigir o erro 504 Gateway Timeout

O que é o erro 504 no WordPress?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o erro 500 Internal Server Error

Como corrigir o erro 503 Service Unavailable

Como corrigir o erro 404 Not Found no WordPress

Como corrigir o erro 429 Too Many Requests

Como corrigir erro 524 A Timeout Occurred (Cloudflare)

Como corrigir o erro 408 Request Timeout

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos