Correção WordPress 502 Bad Gateway / Timeout
Um erro 502 Bad Gateway no WordPress significa que o servidor recebeu uma resposta inválida de um servidor upstream — geralmente PHP-FPM travando ou sobrecarregado, má configuração do Nginx ou um timeout de gateway de um script PHP lento.
Por Que Este Erro Acontece?
Causas mais comuns que diagnosticamos:
Como Corrigimos — Passo a Passo
Processo sistemático, rápido e seguro:
Verificar o status e logs do PHP-FPM
Execute: systemctl status php-fpm e verifique /var/log/php-fpm/error.log para mensagens "server reached pm.max_children" ou de falha.
Aumentar os valores de timeout do Nginx
No nginx.conf ou na configuração do site, adicione: fastcgi_read_timeout 300; proxy_read_timeout 300; fastcgi_connect_timeout 300;
Escalar o pool de PHP-FPM
Edite /etc/php-fpm.d/www.conf: aumente pm.max_children para lidar com mais solicitações simultâneas. Para 2GB de RAM: defina para 40-60.
Você está lidando com isso agora?
Nosso especialista WordPress responde em minutos.
Perguntas Frequentes
QQual é a diferença entre 502 e 504 no WordPress?
502 Bad Gateway significa que o servidor recebeu uma resposta inválida do upstream (PHP-FPM travou ou reiniciou a conexão). 504 Gateway Timeout significa que o upstream demorou muito para responder (timeout do script PHP).
QPor que recebo 502 apenas às vezes e não sempre?
502s intermitentes geralmente significam que seu pool de PHP-FPM está ocasionalmente ficando sem trabalhadores durante picos de tráfego — um problema de escalabilidade, não um bug de código.
QQual é a diferença real entre 502, 503, 504 e 500?
500: erro do servidor na sua aplicação. 502: bad gateway — o proxy recebeu uma resposta inválida do upstream. 503: serviço indisponível. 504: gateway timeout — o proxy esperou muito pelo upstream. 502 e 504 são mais comuns com configurações WordPress/Nginx.
QPor que estou recebendo 502 apenas em páginas administrativas pesadas?
Páginas pesadas (listas administrativas com muitos registros, importação de dados, geração de relatórios) demoram mais do que o timeout do PHP-FPM (padrão 30 segundos). O proxy expira esperando e retorna 502. Aumentamos os timeouts fastcgi e otimizamos a consulta lenta.
QUm fastcgi_pass nginx errado pode causar 502?
Sim. Se o nginx estiver configurado para se comunicar com o PHP-FPM em um caminho de socket errado (por exemplo, /var/run/php-fpm.sock que não existe mais), cada solicitação retorna 502. Verificamos se o endereço de escuta real do PHP-FPM corresponde ao fastcgi_pass do nginx.
QPor que o PHP-FPM trava e causa 502?
Causas comuns: falha de segmentação do PHP (raro, geralmente de uma extensão com bugs), PHP-FPM atingindo o limite pm.max_children e recusando conexões, ou PHP-FPM ficando sem memória e sendo morto pelo OOM killer.
QComo aumento os trabalhadores do PHP-FPM para evitar 502?
Edite /etc/php/8.x/fpm/pool.d/www.conf e aumente pm.max_children com base na RAM do seu servidor. Cada trabalhador PHP geralmente precisa de 64-128MB. Servidor com 8GB de RAM e 100MB por trabalhador = 60-70 trabalhadores seguros.
QMudar de FastCGI para módulo Apache corrigirá 502?
Talvez — mas geralmente move o problema em vez de resolvê-lo. Apache mod_php é mais simples, mas usa mais memória por solicitação. Diagnosticamos o verdadeiro gargalo primeiro em vez de mudar arquiteturas.
QUma consulta de banco de dados lenta pode causar 502?
Sim. PHP esperando pelo MySQL excede o timeout do proxy. Identificamos consultas lentas através do slow_query_log, adicionamos índices e otimizamos a consulta ou implementamos cache.
QPor que o 502 acontece aleatoriamente mesmo com pouco tráfego?
Processos em segundo plano podem aumentar o uso de recursos: cron jobs, plugins de backup, regeneração de imagens. Verificamos o tempo das ocorrências de 502 em relação às tarefas agendadas para encontrar o gatilho.
QO Cloudflare armazenará em cache respostas 502 e continuará mostrando-as?
O Cloudflare não armazena em cache erros 5xx por padrão, mas se você tiver regras de cache agressivas incluindo 5xx, sim. Sempre configuramos regras de cache adequadas excluindo respostas de erro.
QComo verifico se o 502 é do upstream ou do próprio proxy?
Veja seus logs de acesso vs logs de erro: se o 502 aparecer no log de erro E no log de acesso, é do seu nginx/Apache. Se apenas no log de acesso com status=502, provavelmente é de um CDN ou balanceador de carga acima. Trace as camadas cuidadosamente.
QUm problema de rede do provedor de hospedagem pode causar 502 aleatoriamente?
Sim. Sobrecargas de hospedagem compartilhada, ataques DDOS afetando o data center ou problemas de backbone podem causar 502s esporádicos. Podemos identificar isso através de padrões de monitoramento de uptime que correspondem à página de status do host.
QMover para uma versão diferente do PHP reduzirá 502?
Frequentemente sim. O PHP 8.x tem menor uso de memória e execução mais rápida, reduzindo a chance de timeouts e esgotamento de trabalhadores. Testamos a compatibilidade antes de recomendar mudanças de versão do PHP.
QComo posso monitorar erros 502 automaticamente?
Configuramos: monitoramento de uptime (UptimeRobot, BetterStack) com alertas de status HTTP, análise de logs com alertas na frequência de 502 e Application Performance Monitoring (New Relic, Datadog) para a saúde do upstream.
Serviço Completo: Recuperação de Velocidade do WordPress
Site WordPress de repente lento? Diagnosticamos gargalos de desempenho e restauramos sua velocidade.
WordPress Emergency Support
Response in minutes. No data loss. No diagnosis charge.
wpfix.blimx.com