# Como corrigir o erro 502 Bad Gateway no WordPress

O erro 502 Bad Gateway é um código HTTP que indica que um servidor atuando como gateway ou proxy recebeu uma resposta inválida do servidor de origem. No WordPress, costuma vir do PHP-FPM travado ou reiniciando, do servidor sobrecarregado ou de uma camada de CDN/proxy como o Cloudflare sem resposta válida do host.

## 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

Erros relacionados

- [Como corrigir o erro 500 Internal Server Error](https://full.services/wp-fixer/como-corrigir-erro-500-wordpress/)
- [Como corrigir o erro 503 Service Unavailable](https://full.services/wp-fixer/como-corrigir-erro-503-wordpress/)
- [Como corrigir o erro 504 Gateway Timeout](https://full.services/wp-fixer/como-corrigir-erro-504-wordpress/)

## 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

1. 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.
2. 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.
3. 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.
4. 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.
5. 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?

Quase sempre da camada de servidor. O 502 significa que um gateway não recebeu resposta válida do backend. O conteúdo do WordPress raramente é a causa direta; o gargalo costuma estar no PHP-FPM, na carga do servidor ou na CDN.

### O 502 some sozinho. Por que ele volta?

Porque costuma ser intermitente: o processo PHP satura em picos de tráfego ou em tarefas pesadas e se recupera depois. Ele volta sempre que a carga sobe de novo. A solução de fundo é dimensionar melhor o servidor e usar cache.

### Erro 502 e erro 504 são a mesma coisa?

São parecidos, mas não iguais. No 502 o gateway recebe uma resposta inválida do backend. No 504 o gateway não recebe resposta nenhuma dentro do tempo limite. Ambos vivem na camada de servidor, mas indicam falhas diferentes.

### Uso Cloudflare e vejo 502 com a marca dele. O que fazer?

Isso indica que o Cloudflare não conseguiu uma resposta válida do seu host de origem. Ative o Development Mode ou pause o proxy e acesse o site pelo IP direto. Se abrir, o problema está entre o Cloudflare e o host, não no WordPress.

### Por que não há código para colar para corrigir o 502?

Porque o 502 não se resolve editando arquivos do WordPress. A correção fica em reiniciar serviços (PHP-FPM, Nginx), aliviar a carga e ajustar timeouts e limites no servidor, ações que dependem do painel da hospedagem ou do suporte.

### Reiniciei o servidor e o 502 voltou em minutos. E agora?

Reiniciar só limpa processos travados; se a carga real excede a capacidade do plano, ele satura de novo. Verifique nos logs qual rota ou tarefa estoura o PHP, reduza requisições com cache e, se persistir, suba o plano de hospedagem.

**Fonte:** [MDN Web Docs — 502 Bad Gateway](https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Status/502)