Como corrigir o erro 502 bad gateway: 10 métodos

O erro 502 Bad Gateway acontece quando há uma falha de comunicação entre servidores, isto é, quando um servidor que funciona como gateway ou proxy não consegue obter uma resposta válida do servidor principal.

A questão é que esse tipo de erro não afeta todo mundo da mesma forma. Em alguns casos, é apenas uma falha temporária que desaparece ao atualizar a página; em outros, pode indicar um problema mais sério no servidor que precisa ser corrigido. A boa notícia é que o erro 502 muitas vezes pode ser resolvido com ações simples que você mesmo pode realizar.

Para corrigi-lo, você pode atualizar o navegador, verificar o status do site, limpar o cache, testar no modo anônimo, redefinir as configurações de DNS, tentar acessar de outro dispositivo, revisar os logs do servidor, desativar plugins ou temas, conferir as configurações da CDN e ajustar os limites de tempo de execução do PHP.

A seguir, vamos mostrar cada solução passo a passo, começando pelas mais rápidas e seguindo para opções de diagnóstico mais avançadas. Assim, quando a mensagem de erro 502 aparecer novamente, você já vai saber exatamente o que fazer.

O que causa o erro 502 Bad Gateway?

O erro 502 Bad Gateway acontece quando um servidor não consegue se comunicar corretamente com outro. Isso pode ser causado por falhas de rede, sobrecarga, configurações incorretas ou aplicativos com erro que interrompem a troca de dados entre os sistemas.

Abaixo estão as principais causas e o que cada uma significa:

Causa	Descrição
Sobrecarga do servidor	O servidor de origem recebe muitas solicitações ao mesmo tempo e não consegue responder dentro do prazo.
Problemas de conectividade	Falhas na rede entre os servidores, como timeouts ou quedas na conexão.
Servidor fora do ar	O servidor está temporariamente offline, em manutenção ou travou.
Restrições de firewall	Regras de segurança bloqueiam a comunicação entre os servidores.
Problemas de DNS	Falhas na resolução de domínio impedem que os servidores se conectem.
Configuração incorreta de proxy ou gateway	Erros nas configurações do servidor intermediário que processa as requisições.
Erros na aplicação	Bugs ou travamentos no código da aplicação geram respostas inválidas.
Problemas na CDN	Falhas nos servidores da rede de distribuição de conteúdo.
Falhas na conexão com o banco de dados	O servidor web não consegue acessar o banco para obter informações.
Timeout em scripts PHP ou similares	O script demora para executar e expira antes de concluir.

O complicado é que, para quem está acessando o site, todos esses cenários geram exatamente a mesma mensagem de erro 502, mesmo quando a causa é completamente diferente. Por isso, a correção costuma envolver a tentativa de várias soluções até encontrar a origem do problema.

Como corrigir o erro 502 Bad Gateway

Na maioria dos casos, o erro 502 Bad Gateway é temporário – basta aguardar cerca de 30 segundos para que ele desapareça. Para solucionar mais problemas, tente o seguinte:

1. Atualize a página

Normalmente, o erro 502 Bad Gateway é temporário, decorrente de um aumento repentino de tráfego. Uma rápida atualização pode resolver o problema.

No Windows, pressione F5 ou CTRL + F5. No Mac, use CMD + R.

2. Verifique o status do site

Se o código de erro 502 ainda estiver sendo exibido, é possível que o servidor do site esteja passando por um período de inatividade.

Felizmente, há muitas ferramentas para examinar se o site está fora do ar, incluindo Down for Everyone ou Just Me e IsItDown. Basta inserir o URL desejado e verificar o status do site.

3. Limpe o cache do navegador

Se o erro de resposta inválida persistir, é possível que o cache do navegador tenha salvo arquivos desatualizados e corrompidos. Nesse caso, limpar o cache do navegador pode ser uma correção para o 502 Bad Gateway.

Lembre-se de que a remoção de arquivos em cache pode resultar na perda de dados importantes do navegador, incluindo favoritos e preferências de configuração. Para evitar isso, basta exportar seus dados do navegador e importá-los novamente depois.

4. Tente acessar o site numa guia anônima

Acesse o site numa aba anônima para determinar se o tempo limite do gateway 502 aparece devido a um problema relacionado ao navegador. Para abrir uma janela anônima, clique no botão de três pontos na tela do navegador e escolha Nova janela anônima.

Se o erro não ocorrer no modo de navegação anônima, é provável que alguma extensão do navegador esteja causando o problema.

Tente desativar seus complementos ou extensões um a um. Ao excluir a extensão que está causando o erro, você deverá conseguir acessar o site. De acordo com nossa experiência, bloqueadores de anúncios frequentemente são os maiores culpados pelo erro 502.

Se isso não ajudar, tente usar um navegador diferente. Por exemplo, se você estiver usando o Google Chrome, tente usar o Mozilla Firefox.

Se a página funcionar no novo navegador, algum aspecto do outro browser pode estar causando o erro. Para resolver o problema, tente excluir e reinstalar o navegador com defeito.

5. Limpe o cache do DNS

Outras causas comuns do 502 Bad Gateway são problemas de DNS, como endereços IP incorretos e servidores DNS que não respondem.

Nesse caso, limpar o cache do DNS pode ser a solução. Esse método funciona de forma semelhante à limpeza do cache do navegador: ele removerá os arquivos defeituosos do seu servidor DNS.

Considere também alterar temporariamente seus servidores DNS. Por padrão, seu provedor de internet atribui seus servidores DNS automaticamente. No entanto, você sempre pode alterá-lo para um servidor de terceiros, como o DNS Público do Google.

6. Teste em outro dispositivo

Se nenhuma das soluções de erro 502 acima funcionar, teste sua conexão com a internet em outro computador ou dispositivo móvel, de preferência conectado a uma rede diferente.

Além disso, tente reiniciar o computador e o roteador. Isso mostrará se o erro está relacionado ao seu equipamento de rede ou se o problema está em outro lugar.

7. Verifique os registros de erros

Se você encontrar um erro 502 no site após uma alteração ou atualização, pode estar lidando com um erro no servidor da web. A melhor forma de resolver esse problema é verificar o registro de erros do site.

Normalmente, seu servidor para sites permite acessar o log de erros do site por meio de um painel de administração. Você também pode ativar o log de erros no seu site WordPress adicionando as seguintes linhas no wp-config.php:

define( 'WP_DEBUG', true ); 
define( 'WP_DEBUG_LOG', true ); 
define( 'WP_DEBUG_DISPLAY', false );

Todos os erros gerados aparecerão no arquivo wp-contents/debug.log, permitindo que você detecte quais estão causando o erro 502 Bad Gateway.

8. Verifique plugins e temas

Às vezes, plugins ou temas com defeito podem causar o erro 502.

Isso ocorre porque plugins e temas mal codificados podem entrar em conflito uns com os outros. Quando isso acontece, seu servidor interrompe todos os scripts e consultas em seu site, tornando-o inacessível.

Em alguns sites, o problema geralmente é causado por plugins de cache ou de segurança. Há uma boa chance de que esses plugins bloqueiem a comunicação entre os servidores, fazendo com que o erro persista.

Se você não tiver um plugin de cache ou de segurança instalado, mas ainda assim estiver encontrando o erro HTTP 502, uma boa ideia desativar seus plugins e reativá-los um a um. Para fazer isso, vá até Plugins e clique em Desativar no menu Ações em massa.

Em seguida, ative cada plugin e atualize o site após ativar cada um deles. Quando o erro 502 aparecer novamente, você terá encontrado o plugin com problema.

No entanto, se você não conseguir acessar o painel do WordPress, tente desativá-los no painel de hospedagem ou em um cliente FTP. Navegue até o diretório wp-content e renomeie o diretório de plugins, por exemplo, para plugins-disable.

Se você usa a Hostinger, acesse seu hPanel e clique em Arquivos. A partir daí, vá para Gerenciador de Arquivos → public_html → wp-content. 

Quando o site voltar a funcionar depois que todos os plugins forem desativados, você poderá renomear a pasta novamente para plugins. Em seguida, tente ativar os plugins um a um para determinar qual deles causou o erro.

Se o site continuar com problema e você estiver usando um tema customizado, premium ou um child theme, tente ativar um dos temas padrão do WordPress. Para isso, vá em Aparência → Temas, clique em Adicionar tema, procure por um dos temas padrão do WordPress que ainda não esteja instalado — como o Twenty Twenty-Five — e clique em Instalar. Aguarde alguns segundos e, assim que o botão Ativar aparecer, clique nele.

Se o site ainda não estiver funcionando, siga as mesmas etapas com seus temas do WordPress.

9. Verifique sua rede de distribuição de conteúdo (CDN)

Outra causa dos erros 502 Bad Gateway podem ser problemas com sua rede de distribuição de conteúdo (CDN) ou serviços de proteção de DDoS.

Uma CDN adiciona uma camada extra entre o servidor e o navegador para carregar conteúdo da internet com mais eficiência. No entanto, essa camada pode apresentar problemas ao se conectar com seu servidor de origem, resultando em erros 502.

Um exemplo notável é o Cloudflare, onde o 502 Bad Gateway pode ocorrer em duas variações diferentes, dependendo do problema.

A tela acima indica que o problema está no lado do Cloudflare. Para corrigi-lo, você precisará entrar em contato com a equipe de suporte técnico da empresa. Lembre-se de verificar a página de status do sistema da Cloudflare antes de fazer isso.

Como alternativa, você pode desativar o Cloudflare. No entanto, lembre-se de que a propagação do DNS pode levar algumas horas.

Se você vir o erro do Cloudflare mostrado acima, isso significa que o problema está no seu provedor de hospedagem. Nesse caso, tente entrar em contato com a equipe de suporte do provedor e peça ajuda.

10. Aumente o max_execution_time e o max_input_time do PHP

O timeout do PHP ocorre sempre que um processo PHP é carregado por mais tempo do que o max_execution_time ou o max_input_time especificados. Esses são os valores definidos nas configurações do PHP em seu servidor web. Normalmente, os valores são definidos como 300 segundos, por padrão.

Um timeout pode ocorrer durante o processo de migração e disparar um erro 502 Bad Gateway. Para corrigir esse problema, entre em contato com o suporte ao cliente do seu provedor de hospedagem para verificar quais são os valores definidos e se é possível aumentá-los.

Como corrigir o erro 502 Bad Gateway – tutorial em vídeo

Se você preferir acompanhar um tutorial em vídeo, confira este guia da Hostinger sobre como resolver esse erro:

Variações do erro 502 Bad Gateway

Um erro 502 pode aparecer em qualquer dispositivo, serviço ou sistema operacional, mas a mensagem específica pode ser diferente dependendo da plataforma. Aqui estão algumas variações desse código de status HTTP que você pode ver:

• Simples – Temporary Error (502), Erro 502, 502 Error.
• Descritivo – Erro HTTP 502 Bad Gateway, 502 Server Error, com uma explicação.
• Técnico – 502 – Web server received an invalid response while acting as a gateway or proxy server, HTTP 502, 502 Proxy Error.
• Sobrecarga – 502 Service Temporarily Overloaded.
• Específico do servidor – 502 Bad Gateway Nginx, dependendo do software do servidor.
• Tela em branco – alguns sites mostram uma tela branca.

Alguns sites e navegadores possuem páginas de erro próprias, com informações adicionais. Por exemplo, o Chrome oferece dicas de solução de problemas e sugere tentar novamente.

O GitLab explica o problema de comunicação e fornece soluções.

O X (antigo Twitter), por outro lado, costumava exibir uma mensagem amigável com uma ilustração.

O erro 502 Bad Gateway é permanente?

Na maioria dos casos, o erro 502 Bad Gateway não é uma falha permanente no site. Muitas vezes ele desaparece sozinho em poucos minutos, ou pode ser resolvido rapidamente ao atualizar a página, limpar o cache do navegador ou aplicar alguma das soluções que citamos anteriormente.

O erro 502 Bad Gateway afeta o SEO?

Mesmo sendo temporários, os erros 502 podem prejudicar o ranqueamento do site se persistirem por muito tempo.

Isso acontece porque mecanismos de busca como o Google priorizam páginas acessíveis e estáveis. Se um site fica frequentemente indisponível por causa de falhas no servidor, suas posições nos resultados de pesquisa podem cair. Se quiser entender melhor o que influencia o desempenho do seu site, consulte nosso guia de SEO.

O mais importante é agir rápido quando perceber um erro 502 no site. Comece pelas correções mais simples e avance, se necessário, para soluções técnicas mais detalhadas. Na maioria dos casos, dá para resolver tudo sem ajuda profissional.

Lembre-se: o erro 502 é irritante, mas tem solução. Guarde este guia para consultar na próxima vez que o problema aparecer e você já vai saber por onde começar.

Agora, se o seu site enfrenta erros 502 com frequência — especialmente aqueles ligados a falhas de conexão com o banco de dados — isso pode ser sinal de um problema mais sério com a sua hospedagem. Se o provedor atual não consegue oferecer uma solução prática, pode ser a hora de considerar uma hospedagem WordPress gerenciada, como a da Hostinger.