Erro 502 Bad Gateway: o que é e como resolver
Oi! Aqui é a Sensei, da equipe GeHost 👋 Se o seu site apareceu com a mensagem "502 Bad Gateway", respira fundo: na maioria das vezes é algo simples de resolver, e vou te guiar passo a passo até deixar tudo funcionando de novo.
Em bom português: o erro 502 significa que o servidor recebeu a visita de alguém querendo abrir seu site, mas não conseguiu completar a resposta a tempo — geralmente porque algum script (um plugin, um tema ou um arquivo do site) travou ou demorou demais pra responder.
1. Antes de tudo: confirme que não é só você
- Abra o site em outro navegador ou no celular (fora do wi-fi de casa, se possível, usando os dados móveis).
- Se abrir normalmente para outras pessoas, pode ser um probleminha passageiro no seu navegador — tente limpar o cache ou abrir numa aba anônima.
- Se o erro aparecer para todo mundo, siga para os próximos passos. 💪
2. Dê uma segunda chance ao site
Muitas vezes o 502 é um pico momentâneo (um script pesado rodando, uma atualização em andamento). Aguarde de 2 a 5 minutos e atualize a página (F5). Se o site voltar sozinho, ótimo — não precisa fazer mais nada.
3. Ainda com erro? Vamos direto na causa mais comum: plugin ou tema com problema
Se o seu site é feito em WordPress (ou outro CMS com plugins/temas), o 502 costuma aparecer depois de instalar ou atualizar um plugin/tema que não é compatível. Para verificar isso, você vai precisar entrar no cPanel (o painel de gerenciamento do seu site).
- Acesse o cPanel da sua hospedagem e faça login com o usuário e senha que você recebeu na contratação.
- Depois de logar, você verá a tela inicial do cPanel, com vários grupos de ferramentas (E-mail, Arquivos, Bancos de Dados etc.).
- Procure e abra o Gerenciador de Arquivos (Files Manager).
- Navegue até a pasta do seu site (geralmente public_html).
- Se for WordPress, entre em wp-content/plugins e renomeie essa pasta inteira (por exemplo, de "plugins" para "plugins-teste"). Isso desativa todos os plugins temporariamente, sem apagar nada.
- Teste o site de novo. Se voltar ao normal, o problema era um plugin. Renomeie a pasta de volta para "plugins" e vá ativando os plugins um por um (pelo painel do WordPress) até identificar qual deles causa o erro.
Dica da Sensei: nada é apagado ao renomear a pasta — é só uma forma segura de "pausar" tudo pra descobrir o culpado, sem perder nenhum arquivo.
4. Se não for plugin/tema, pode ser um arquivo de configuração corrompido
Um arquivo .htaccess mal configurado (às vezes editado por engano ou por outro plugin) também pode causar o 502. No mesmo Gerenciador de Arquivos, localize o arquivo .htaccess dentro de public_html, renomeie-o (ex.: ".htaccess-old") e teste o site novamente. Se resolver, esse arquivo estava com algum erro de sintaxe e pode ser recriado pelo próprio CMS.
5. Nada disso resolveu? Chame a gente 🙋
Se você já tentou os passos acima e o erro continua, pode ser algo no lado do servidor que precisa da nossa análise técnica — e aí é com a gente mesmo, sem problema nenhum. Abra um chamado no painel.gehost.com.br contando:
- Quando o erro começou a aparecer;
- O que mudou no site pouco antes disso (plugin, tema, arquivo, alguma atualização);
- Se o erro é constante ou vai e volta.
Lembrando que todo serviço entregue pela GeHost já vem com 30 dias de suporte grátis após a entrega — e fora desse período, nossa equipe também está pronta pra te ajudar sempre que precisar. 💚
Resumo rápido:
- Espere alguns minutos e atualize a página;
- Renomeie a pasta de plugins (ou o tema) para testar;
- Renomeie o .htaccess para descartar erro de configuração;
- Persistindo, abra um chamado no painel.gehost.com.br.
Qualquer dúvida durante esses passos, pode chamar — a gente resolve juntos! 🚀
