Como corrigir o erro 502 bad gateway a partir da tela de erro

O que cada tela de 502 indica, o que o gestor confere sozinho e em quantos sites do Ibovespa há um intermediário no caminho.

O erro 502 bad gateway significa que um servidor intermediário, como uma CDN, um proxy ou um balanceador, pediu a página ao servidor onde o site está instalado e recebeu de volta uma resposta inválida, ou nem conseguiu conversar com ele. O visitante chegou à porta da frente, mas a porta da frente não conseguiu buscar o site lá dentro. Por isso a correção quase nunca está no navegador de quem acessa: ela começa por descobrir qual dos dois servidores falhou, e a própria tela de erro costuma dizer.

Esse intermediário está na maior parte dos sites de empresa grande. Em 22/10/2026, a J1 Studio leu os cabeçalhos de resposta dos sites que as empresas da carteira do Ibovespa cadastram na B3: dos 63 que responderam, 53 passam por uma CDN, um firewall de borda ou um balanceador antes de chegar ao servidor de origem. Em cada um desses 53 sites, um 502 pode nascer em dois lugares, e cada lugar tem um responsável diferente.

O que é erro 502 bad gateway

O erro 502 é o código que o HTTP, o protocolo que leva as páginas até o navegador, reserva para o gateway inválido, a tradução mais próxima de bad gateway. A documentação do MDN (atualizada em 07/07/2025) diz que o servidor que devolve o 502 está atuando como intermediário e recebeu uma resposta inválida do servidor para o qual encaminhou o pedido. A RFC 9110, a especificação do HTTP publicada pela IETF em 2022, traz a mesma definição.

Na prática, uma visita percorre dois trechos. No primeiro, o navegador fala com o intermediário: a CDN, rede que entrega o site a partir de servidores próximos do visitante, o firewall, que filtra o tráfego, ou o balanceador, programa que divide os acessos entre servidores. No segundo, o intermediário fala com o servidor de origem, onde o WordPress roda. O 502 é uma falha no segundo trecho, relatada por quem está no primeiro.

Os vizinhos da família 500 apontam para outros lugares. O erro 500 é uma falha no código do próprio site, o erro 503 é uma recusa com prazo, típica de manutenção, e o 504 é o intermediário que esperou e não recebeu resposta a tempo. Quando a tela nem chega a mostrar um código, o roteiro é o de site fora do ar.

Como a tela do erro 502 mostra onde está o problema

Cada intermediário tem uma página de erro própria, e o formato dela é a primeira pista. A documentação da Cloudflare (atualizada em 12/10/2026) traz a regra que mais confunde: a página de 502 com o layout da Cloudflare, que desenha o caminho entre o navegador, a Cloudflare e o servidor, indica falha no servidor de origem; já a página branca, só com “502 Bad Gateway” e a palavra “cloudflare” embaixo, indica falha na própria Cloudflare. O que separa os dois casos é o layout da página, não o nome que aparece nela.

A documentação do CloudFront, a CDN da Amazon, consultada em 22/10/2026, lista entre as causas do 502 o certificado de segurança da origem vencido ou inválido e o erro de DNS, o sistema que traduz o nome do site no endereço do servidor. Já a página branca com “502 Bad Gateway” e a palavra “nginx” embaixo vem do Nginx, programa que muitas hospedagens colocam na frente do WordPress para receber as visitas.

Tela de erroOnde falhouQuem resolve
Página com o layout da CloudflareServidor de origemHospedagem e equipe técnica
Página branca com “cloudflare” embaixoRede da Cloudflare ou compactação com defeito na origemQuem administra a CDN, com o log da hospedagem
“502 ERROR The request could not be satisfied”Ligação do CloudFront com a origemQuem administra a CDN e a hospedagem
“502 Bad Gateway” com “nginx” embaixoProcesso do PHP no servidorHospedagem e equipe técnica
Reprodução ilustrativa de quatro telas de erro 502: página com o desenho do caminho entre navegador, CDN e servidor, com o servidor marcado em erro, que indica falha na origem; página branca com 502 Bad Gateway e a palavra cloudflare embaixo, falha na rede da Cloudflare; página com 502 ERROR The request could not be satisfied, do CloudFront; e página branca com 502 Bad Gateway e a palavra nginx embaixo, o Nginx sem resposta válida do PHP do servidor.
Reprodução ilustrativa das quatro telas mais comuns do erro 502 e do ponto onde cada uma indica a falha.

Na mesma leitura de 22/10/2026, 13 dos 53 sites com intermediário responderam ao nosso teste com uma página de bloqueio emitida pelo intermediário (CDN ou firewall de borda), e não pelo site, sinal de que a tela que o visitante vê nem sempre vem de quem hospeda a página. Os 10 sites sem intermediário visível no cabeçalho podem ter um que não se identifica, e por isso a conta de 53 é um piso.

Infográfico da medição da J1 Studio em 22/10/2026: 53 de 63 sites de empresas do Ibovespa passam por um intermediário; barras com Cloudflare em 16 sites, Akamai em 13, CloudFront em 7 e outros 7 fornecedores de 1 a 5 sites cada; 6 sites com duas camadas e 10 sem intermediário visível.
Medição da J1 Studio em 22/10/2026 nos sites que as empresas da carteira do Ibovespa cadastram na B3.

Como corrigir o erro 502?

O erro 502 se corrige no servidor, e o gestor acelera a correção quando entrega à equipe técnica a pista certa. A primeira parte não exige acesso técnico, nesta ordem:

  1. Espere um minuto e recarregue: um 502 isolado costuma ser o servidor de origem reiniciando um processo, e some sozinho.
  2. Teste fora da rede da empresa: abra o site pelo celular, com dados móveis, para saber se o erro vale para todos os visitantes.
  3. Fotografe a tela e anote a hora: a marca na página, ou a falta dela, diz qual trecho falhou, como mostra a tabela acima.
  4. Pergunte o que mudou: troca de hospedagem, renovação do certificado, mudança no DNS ou plugin novo nas últimas horas ficam perto da maior parte das causas.

Limpar o cache do navegador e reiniciar o roteador, os primeiros passos de boa parte dos tutoriais, não mudam a resposta de um servidor que está do outro lado. O mesmo vale para o 502 num sistema que a empresa usa e não controla, como o PJe ou um portal de nota fiscal: a correção é de quem mantém o serviço.

Do lado do servidor, uma das causas num WordPress é o processo do PHP interrompido no meio do pedido. O PHP é a linguagem em que o WordPress roda, e o processo cai quando um plugin consome toda a memória permitida, quando a hospedagem troca a versão do PHP ou quando as visitas simultâneas passam do limite do plano. A equipe técnica confirma no log de erros do servidor, na hora anotada, e corrige a causa em vez de só reiniciar o serviço.

Para a busca, um 502 de minutos não pesa. A página do Google sobre códigos de status (atualizada em 06/03/2026) diz que os erros da família 5xx fazem o robô desacelerar o rastreamento e que as páginas com erro persistente saem do índice.

Como posso resolver o erro 502 no Cloudflare?

No Cloudflare, o primeiro passo é olhar o layout da página: com o desenho do caminho entre navegador, Cloudflare e servidor, o problema está na hospedagem; na página branca com “cloudflare” embaixo, a suspeita recai sobre a rede da Cloudflare. Para o primeiro caso, a documentação de 12/10/2026 aponta três causas na origem: o servidor não responde para aquele domínio, está sobrecarregado ou caiu, ou uma aplicação demorou demais ou foi bloqueada. Num site WordPress, isso aparece como o firewall da hospedagem barrando os endereços da Cloudflare ou como o DNS ainda apontando para o servidor antigo depois de uma migração de site.

A mesma documentação faz uma ressalva: a página branca também aparece quando a origem entrega conteúdo compactado com defeito, como um arquivo gzip quebrado ou um tamanho declarado que não bate com o conteúdo enviado. Por isso o log da hospedagem entra nos dois casos, mesmo quando a tela aponta para a Cloudflare.

Pausar a Cloudflare para testar, conselho comum nos tutoriais, revela o endereço do servidor de origem e deixa o site sem a proteção da CDN enquanto o teste durar. O caminho mais seguro é abrir o log da hospedagem na hora anotada. Se a falha for da Cloudflare, o suporte dela pede a hora com o fuso, o endereço que deu erro e o resultado da página /cdn-cgi/trace do domínio. O papel da CDN nesse caminho está no guia sobre o que é CDN.

Quando o erro 502 volta a cada pico de acesso

Um WordPress bem feito resolve a grande maioria dos projetos de site de uma empresa, e o 502 isolado de um minuto é só o caminho se ajustando. O que custa caro é o 502 que volta a cada pico de acesso ou a cada renovação de certificado, com a CDN e a hospedagem apontando uma para a outra. Numa rotina de manutenção de sites WordPress, alguém lê o log da origem e o painel da CDN na mesma hora, e o chamado sai com a camada certa já identificada.

Avalie esse post
Compartilhe esse conteúdo
Jofran Lirio
Jofran Lirio

Jofran Lirio é fundador da J1 Studio e trabalha com WordPress há mais de 15 anos, somando +400 clientes atendidos. Escreve sobre desenvolvimento, performance e manutenção para gestores que levam a presença digital a sério.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *