Como corrigir o erro 502 Bad Gateway no WordPress
O que é o erro 502 Bad Gateway no WordPress?
O erro 502 Bad Gateway no WordPress aparece quando um servidor intermediário (o Nginx na frente do PHP-FPM, ou uma CDN como Cloudflare na frente do seu host) tenta buscar a página, mas o servidor de origem devolve uma resposta inválida ou nenhuma resposta. O problema quase nunca está no conteúdo do WordPress em si: está na camada de servidor, no processo de PHP ou na conexão entre as camadas, por isso a correção passa mais por reiniciar serviços e aliviar carga do que por editar arquivos do site.
Como identificar
- Mensagem “502 Bad Gateway” ou “502 Bad Gateway nginx” no navegador, muitas vezes em página simples sem o tema.
- O site fica intermitente: carrega numa atualização e cai na seguinte, sinal de processo PHP saturado.
- O erro coincide com picos de tráfego, com uma tarefa pesada (importação, backup) ou com a reinicialização do servidor.
- Se você usa Cloudflare, a tela de erro 502 mostra a marca do Cloudflare apontando que o host de origem não respondeu.
Como prevenir
- Escolha um plano de hospedagem com workers PHP e memória compatíveis com o tráfego real do site
- Use cache de página para reduzir a quantidade de requisições que chegam ao PHP em picos
- Agende tarefas pesadas (backup, importação) para horários de baixo tráfego e monitore o uso de CPU
Causa
- Processo PHP-FPM travado, sem workers livres ou reiniciando, deixando o Nginx sem resposta do upstream.
- Servidor de origem sobrecarregado por pico de tráfego ou por uma tarefa pesada consumindo toda a CPU/memória.
- Timeout entre o proxy e o backend (fastcgi_read_timeout do Nginx menor que o tempo de processamento do PHP).
- Camada de CDN/proxy como Cloudflare não recebendo resposta válida do host de origem (host fora do ar ou bloqueando).
- Plugin de cache ou de segurança mal configurado que derruba ou estoura o processo PHP em determinadas rotas.
Como resolver
- Recarregue e aguarde alguns minutos: muitos 502 são momentâneos, causados pelo PHP-FPM reiniciando ou por um pico passageiro. Limpe o cache do navegador e teste de novo antes de mexer em qualquer configuração.
- Reinicie o PHP-FPM e o servidor web: se você tem acesso ao servidor ou ao painel da hospedagem, reinicie o serviço PHP-FPM e o Nginx/Apache. Isso libera workers travados que estavam deixando o gateway sem resposta.
- Pause o Cloudflare em modo desenvolvimento: se usa Cloudflare, ative o Development Mode (ou pause o proxy laranja) e acesse o site direto pelo IP de origem. Se abrir, o 502 está na camada da CDN ou no host respondendo lento.
- Desative plugins de cache e de segurança: via FTP, renomeie a pasta do plugin de cache ou de firewall em wp-content/plugins para testar se ele está estourando o processo PHP em alguma rota.
- Acione o suporte da hospedagem: como o 502 mora na camada de servidor, peça ao host para checar os logs do PHP-FPM, os limites de processos e os timeouts do upstream. Muitas vezes a correção está só nas mãos do provedor.
Perguntas frequentes
O erro 502 é culpa do meu WordPress ou da hospedagem?
O 502 some sozinho. Por que ele volta?
Erro 502 e erro 504 são a mesma coisa?
Uso Cloudflare e vejo 502 com a marca dele. O que fazer?
Por que não há código para colar para corrigir o 502?
Reiniciei o servidor e o 502 voltou em minutos. E agora?
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.
Como corrigir o erro 410 Gone no WordPress
O erro 410 no WordPress é o código HTTP que sinaliza que o conteúdo existia mas foi removido de forma permanente e não voltará. Diferente do 404, o 410 é uma declaração intencional de remoção, usada por plugins de redirecionamento ou pelo próprio site para pedir aos buscadores que desindexem a URL.
Como corrigir o erro 504 Gateway Timeout
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.
Como corrigir erro 521 Web Server is Down
O erro 521 Web Server is Down é um código específico do Cloudflare que indica que ele não conseguiu abrir conexão com o servidor de origem do site. No WordPress, costuma vir do servidor offline, do IP de origem bloqueando os IPs do Cloudflare ou do serviço web parado.
Como corrigir o erro 400 Bad Request
O erro 400 no WordPress é o código HTTP que o servidor devolve quando a requisição chega malformada e ele se recusa a processá-la. As causas mais comuns são cookies do navegador corrompidos, uma URL com caracteres inválidos ou um cabeçalho de requisição grande demais para o servidor.
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.
