Visita o seu site e vê um ecrã branco com três palavras: «502 Bad Gateway». O tráfego está a fluir, mas os visitantes veem um erro em vez do conteúdo. As vendas param, o posicionamento SEO desliza e você perde tempo a tentar adivinhar.

O erro 502 parece assustador, mas, na prática, é apenas uma falha de comunicação entre servidores. O seu site não está avariado, os dados não desapareceram e, na maioria dos casos, a correção demora entre cinco a quinze minutos. Abaixo encontra um guia passo a passo que vai das verificações mais simples aos diagnósticos mais aprofundados.

💡 Resumo rápido:

• Atualize a página e verifique se o servidor de alojamento está em baixo
• Limpe a cache do navegador e desative temporariamente a CDN
• Se o erro persistir, desative os plugins via FTP e verifique o tema
• Reponha o .htaccess e contacte o seu alojamento quando tudo o resto falhar

O que é um erro 502 Bad Gateway

Quando abre um site, o navegador envia um pedido HTTP. Do lado do servidor, um proxy reverso (Nginx, Apache) recebe-o e distribui os pedidos entre o servidor de aplicações (PHP), a base de dados, o servidor web estático e a CDN. Cada nó trata da sua parte e devolve o resultado ao servidor proxy. O proxy monta a resposta e entrega-a ao navegador, e a página carrega.

Um erro 502 ocorre quando um dos servidores nessa cadeia devolve uma resposta inválida ao servidor proxy. O proxy não consegue montar a página e exibe «Bad Gateway». O navegador reporta honestamente que o gateway entre servidores recebeu algo inesperado.

Externamente, o erro pode assumir várias formas: «502 Bad Gateway», «502 Service Temporarily Overloaded», «HTTP 502», «Nginx 502 Bad Gateway», «Proxy Error». A essência é a mesma: algures na cadeia há uma quebra.

Porque é que o erro 502 ocorre

As causas são quase sempre do lado do servidor, mas, por vezes, as suas próprias ações no site podem desencadeá-lo:

• Sobrecarga do servidor. Um pico súbito de tráfego esgota os recursos de alojamento e os processos PHP não conseguem acompanhar a fila de pedidos.
• Plugin ou tema com defeito. Código que causa um erro fatal de PHP termina a resposta do servidor de aplicações e o proxy não recebe nada.
• Problemas com a CDN. A Cloudflare, KeyCDN ou outro serviço de distribuição de conteúdos não consegue ligar-se ao servidor de origem e devolve um 502.
• Registos DNS incorretos. Depois de mudar de alojamento ou atualizar os servidores DNS, os registos ainda não foram propagados, pelo que o site fica temporariamente inacessível.
• .htaccess corrompido. Sintaxe quebrada ou regras de reescrita conflituosas interrompem o tratamento dos pedidos.
• Limite de memória PHP esgotado. Um plugin ou script pesado consome toda a memória disponível e o processo termina abruptamente.

Vamos agora percorrer cada correção passo a passo, da mais rápida à mais complexa.

Passo 1. Atualizar a página

Primeiro e mais simples: prima F5 ou Ctrl+R. Se o erro foi causado por uma falha momentânea do servidor, o pedido repetido será bem-sucedido. Tente abrir o site noutro navegador ou com dados móveis; isto exclui um problema do seu lado.

Verifique se o site funciona para o resto do mundo usando o isup.me ou o Down For Everyone Or Just Me. Se o serviço mostrar que o site está em baixo apenas para si, o problema é local, por isso avance. Se o site estiver indisponível para todos, o servidor de alojamento provavelmente foi abaixo ou foi aplicado um bloqueio ao nível do fornecedor.

Passo 2. Limpar a cache do navegador

O navegador não guarda em cache apenas imagens e estilos, mas também respostas de erro do servidor. Uma atualização forçada (Ctrl+F5 no Windows, Cmd+Shift+R no macOS) obriga o navegador a pedir a página novamente, ignorando a cache local.

Se uma atualização forçada não ajudou, limpe totalmente a cache. No Chrome: Definições → Privacidade e segurança → Limpar dados de navegação → «Imagens e ficheiros em cache». Abordámos instruções detalhadas para vários navegadores e para limpar a cache do lado do WordPress num guia separado.

Passo 3. Desativar temporariamente a CDN

Redes de distribuição de conteúdos como a Cloudflare ou a KeyCDN encaminham o tráfego através dos seus próprios servidores. Se ocorrer uma falha do lado da CDN ou se estiver configurada uma regra de firewall incorreta, os visitantes verão um 502 mesmo quando o servidor de origem está totalmente operacional.

Para testar esta hipótese, coloque a CDN em pausa no seu painel de controlo. Cloudflare: vá a Overview → Pause Cloudflare. KeyCDN e serviços semelhantes: encontre o botão Disable ou Pause no painel. Após desativar, atualize o seu site. Se o erro desaparecer, o problema está do lado da CDN; contacte o suporte deles.

Enquanto a CDN estiver desativada, o site funciona diretamente a partir do seu alojamento, pelo que a velocidade pode cair ligeiramente, mas a disponibilidade será restabelecida. Comparámos serviços CDN populares e a sua configuração num artigo sobre CDNs gratuitas para WordPress.

Passo 4. Verificar as configurações de DNS

Após mudar de alojamento ou atualizar os registos NS, a informação de DNS propaga-se pela rede durante um período que varia de algumas horas a 48 horas. Durante este tempo, alguns visitantes podem aceder ao servidor antigo, que não responde ou responde incorretamente.

Se migrou o seu site recentemente, aguarde 24 horas; normalmente é suficiente. Adicionalmente, limpe a cache DNS local: no Windows, abra a Linha de Comandos e execute ipconfig /flushdns; no macOS, execute sudo dscacheutil -flushcache e sudo killall -HUP mDNSResponder. Depois, atualize a página.

Passo 5. Desativar plugins via FTP

A causa mais comum de um 502 no WordPress é um conflito de plugins. Um único plugin problemático pode causar um erro fatal de PHP que derruba todo o site. Como o painel de administração do WordPress fica inacessível durante um 502, terá de desativar os plugins através do sistema de ficheiros.

Ligue-se ao servidor via FTP (usando FileZilla, WinSCP) ou abra o Gestor de Ficheiros no cPanel. Navegue até à pasta raiz do site (normalmente public_html):

Entre em wp-content e encontre a pasta plugins. Mude-lhe o nome, por exemplo para plugins.old. Isto desativa instantaneamente todos os plugins de uma só vez. Os dados dos plugins não são eliminados ao mudar o nome da pasta; as configurações permanecem na base de dados:

Atualize o site. Se funcionar, o problema está num dos plugins. Volte a mudar o nome da pasta para plugins, aceda ao painel de administração e ative os plugins um a um, verificando o site após cada ativação. Assim que encontrar o culpado, elimine-o via FTP ou substitua-o por uma alternativa.

Passo 6. Verificar o tema ativo

Se desativar os plugins não ajudou, o próximo suspeito é o tema. Código incorreto no functions.php ou um conflito com a versão do PHP pode, de igual modo, causar um erro fatal e um 502.

Volte à pasta raiz do site → wp-content → themes. Encontre a pasta do tema ativo e mude-lhe o nome (por exemplo, acrescente .old no final):

O WordPress passará automaticamente para o tema predefinido (Twenty Twenty-Four, Twenty Twenty-Five ou similar). Atualize o site; se o erro desaparecer, o problema é o tema. Contacte o programador do tema ou restaure uma cópia de segurança. Após o diagnóstico, volte a mudar o nome da pasta para o nome original.

Um algoritmo detalhado para verificar temas e localizar código conflituoso está descrito no guia para resolver problemas com temas do WordPress.

Passo 7. Repor o ficheiro.htaccess

Um .htaccess corrompido é uma causa frequente, mas menos óbvia, de um 502. Regras de reescrita adicionadas por um plugin de cache ou de segurança podem entrar em conflito umas com as outras. Um único erro de sintaxe neste ficheiro e o servidor devolve um 502 em todos os pedidos.

Ligue-se via FTP e localize o ficheiro .htaccess na pasta raiz do site. Descarregue uma cópia de segurança para o seu computador e, em seguida, elimine o ficheiro do servidor. Aceda ao painel de administração do WordPress, navegue até Definições → Links permanentes e clique em «Guardar alterações» (sem alterar nada). O WordPress criará um novo .htaccess com um conjunto limpo de regras.

Se o erro apareceu imediatamente após instalar um plugin de cache (WP Rocket, W3 Total Cache, LiteSpeed Cache), verifique a secção com as regras desse plugin no .htaccess; normalmente está delimitada por comentários como # BEGIN W3TC / # END W3TC. Elimine esse bloco, guarde o ficheiro e atualize o site.

Passo 8. Contactar o seu fornecedor de alojamento

Se nenhum dos passos anteriores ajudou, o problema está muito provavelmente do lado do servidor. Contacte o suporte técnico do seu alojamento e forneça o domínio, a hora a que o erro apareceu e quais os passos que já tomou. Quanto mais detalhes der, mais rapidamente os engenheiros encontrarão a causa.

Peça-lhes para verificar os registos de erros do PHP e do servidor web relativos ao período em que o 502 apareceu. Os registos quase sempre mostram exatamente qual o script ou módulo que está a causar a falha. Em planos de alojamento partilhado económicos, a causa pode ser simplesmente a falta de recursos: um site no servidor consome toda a memória e os restantes recebem um 502. Nesse caso, faz sentido considerar mudar para um VPS ou alojamento cloud com recursos garantidos.

Guia em vídeo

Veja um passo a passo visual de diagnóstico e correção do erro 502, do primeiro ao último passo, neste vídeo:

⁉️🤔 Perguntas frequentes

Um erro 502 pode resolver-se sozinho?

Sim, se a causa for uma sobrecarga momentânea do servidor de alojamento. Os fornecedores monitorizam a carga e reiniciam automaticamente os processos problemáticos no espaço de um a cinco minutos. Atualize a página após alguns minutos; em metade dos casos, o erro desaparece sem qualquer ação da sua parte.

Como distingo um 502 de outros erros de servidor?

Um 502 Bad Gateway é um erro ao nível do servidor proxy (Nginx/Apache), não da aplicação em si. Um 500 Internal Server Error indica um problema diretamente no código PHP ou na configuração. Um 503 Service Unavailable significa que o servidor está temporariamente a não aceitar pedidos, geralmente durante uma manutenção programada. Um 504 Gateway Timeout significa que o servidor não recebeu uma resposta do servidor de origem dentro do tempo estipulado. Para o utilizador, a diferença resume-se ao diagnóstico: um 500 é mais frequentemente corrigido editando código, enquanto um 502 é corrigido restabelecendo a comunicação entre servidores.

Preciso de restaurar o site a partir de uma cópia de segurança para um 502?

Uma cópia de segurança é um último recurso, não um primeiro passo. Antes de repor uma cópia de segurança, siga os passos 5, 6 e 7 deste guia: desative os plugins, verifique o tema, reponha o .htaccess. Na grande maioria dos casos, um 502 resolve-se sem restaurar uma cópia de segurança. Reponha uma cópia de segurança apenas se o erro apareceu imediatamente após atualizar o WordPress, plugins ou um tema e não for possível reverter as alterações via FTP.

Posso prevenir erros 502 no futuro?

Parcialmente, sim. Use alojamento de qualidade com memória PHP suficiente (o mínimo recomendado é 256 MB). Configure a monitorização de tempo de atividade do seu site através do UptimeRobot ou de um serviço semelhante; ficará a saber de um problema antes de os visitantes o reportarem. Antes de instalar ou atualizar plugins, faça uma cópia de segurança rápida. E mantenha o acesso FTP à mão: quando o painel de administração está em baixo, é a única forma de desativar rapidamente código problemático.

O que fazer se nada ajudou?

Os oito passos acima cobrem praticamente todos os cenários de um 502 Bad Gateway no WordPress. Se verificou os plugins, o tema, o DNS e a CDN, repôs o .htaccess e o erro permanece, o problema é mais profundo e não pode prescindir dos engenheiros de alojamento.

A sequência correta poupa horas: primeiro exclua causas locais (cache, navegador, CDN), depois causas do lado do servidor (plugins, tema, .htaccess) e só depois escale para o fornecedor. Guarde este guia nos seus favoritos; um 502 tem o hábito de voltar no pior momento possível e o acesso rápido a esta lista de verificação poupar-lhe-á muito stress.