🎉 USE O CUPOM DESCONTO.FULL | 20% OFF acima de R$ 50,00

Como corrigir o erro 502 Bad Gateway no WordPress

Time Full Services Time Full Services
Tipo Erro HTTP
Nome do erro Erro 502 Bad Gateway EN: 502 Bad Gateway
Severidade Crítico
Descrição 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

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.

Seja PRO.

Tenha acesso a snippets de código premium — PHP, JavaScript, CSS e HTML prontos para usar em seus projetos.

Conhecer o plano Pro →

Uma nova era para o WordPress.

A FULL Services redefine o CMS com uma arquitetura modular que transforma o WordPress em um motor de crescimento digital. 

Painéis personalizados

Um novo nível de controle para o WordPress. Acompanhe métricas, automações e evolução do seu site em um único painel visual.

A força por trás de grandes marcas

Para agências, estúdios e profissionais independentes que desejam oferecer soluções de alto nível com sua própria marca.

Componentes

Hero Sections

30 componentes

Seções de CTA

14 componentes

Login

14 componentes

Blog

14 componentes

Cabeçalhos

24 componentes

Seções de FAQ

53 componentes

Cadastro

53 componentes

Blog individual

53 componentes

Rodapés

28 componentes

Seções de contato

27 componentes

Seções de preços

27 componentes

Faixas

27 componentes

Portfólio

16 componentes

Seções de equipe

12 componentes

Números

12 componentes

Logotipos

12 componentes