O que fazer quando o site apresenta erro 502 (Bad Gateway) ou 504 (Gateway Timeout)

Erro 502 (Bad Gateway) ou 504 (Gateway Timeout): o que fazer

Oi! Aqui é a Sensei da GeHost. 🧘 Se o seu site apareceu com uma tela de erro 502 ou 504, respira: na grande maioria das vezes isso não é o fim do mundo, é só o servidor avisando que algo travou no meio do caminho. Vou te explicar o que cada erro significa e, principalmente, o que você pode fazer agora mesmo pra resolver.

Qual a diferença entre 502 e 504?

• 502 Bad Gateway: o servidor recebeu uma resposta inválida de algum componente interno (por exemplo, o processo que gera as páginas do seu site travou ou reiniciou no momento errado).
• 504 Gateway Timeout: o servidor esperou uma resposta e ela demorou demais pra chegar — geralmente porque algo no site (um plugin, uma consulta ao banco de dados, um script) ficou "pensando" tempo demais.

Na prática, o efeito pro visitante é parecido: a página não carrega. E a lista de causas comuns também se parece bastante, então vamos resolver os dois juntos.

💡 Dica da Sensei: antes de qualquer coisa, tente acessar o site de outro dispositivo ou rede (ex.: dados móveis). Às vezes o problema é só um cache antigo salvo no seu próprio navegador.

Passo 1 — Confirme que não é algo passageiro

1. Espere 1 ou 2 minutinhos e atualize a página (F5 ou Ctrl+R).
2. Limpe o cache do navegador ou tente em uma aba anônima.
3. Se o site usa algum plugin de cache (comum em WordPress), isso pode estar mostrando uma versão "presa" da página. Vale tentar de outro dispositivo pra descartar isso.

Se depois disso o erro continuar, vamos para a investigação.

Passo 2 — Pense no que mudou recentemente

502 e 504 quase sempre aparecem logo depois de uma mudança no site. Pergunte-se:

• Instalei ou atualizei algum plugin/tema recentemente?
• Fiz upload de arquivos novos ou mexi em algum código?
• Alguma automação (importação de produtos, atualização em massa, etc.) está rodando ao mesmo tempo?

Se a resposta for "sim" pra alguma dessas, essa é o suspeito número 1.

Passo 3 — Desative plugins/temas suspeitos pelo Gerenciador de Arquivos

Se o seu site é feito em WordPress (ou outro CMS com plugins) e você não consegue mais acessar o painel administrativo por causa do erro, dá pra "desligar" um plugin problemático direto pelo cPanel, sem precisar de acesso ao site:

1. Entre no cPanel da sua hospedagem e abra o Gerenciador de Arquivos.
2. Navegue até a pasta public_html (ou a subpasta do seu site) e depois wp-content/plugins.
3. Renomeie a pasta do plugin que você suspeita (por exemplo, de nome-do-plugin para nome-do-plugin-desativado). Isso faz o sistema parar de carregá-lo automaticamente.
4. Teste o site novamente. Se voltou ao normal, o plugin era o culpado — aí é só procurar uma versão atualizada dele ou substituí-lo.

💡 Dica da Sensei: nunca exclua a pasta, só renomeie! Assim, se não era o problema, é fácil voltar o nome original e nada se perde.

Passo 4 — Verifique o consumo de recursos

Erros 504 costumam acontecer quando alguma tarefa demora demais e "estoura" o tempo de resposta — isso pode acontecer se o site estiver processando muita coisa de uma vez (uma importação grande, muitas visitas simultâneas, um script mal otimizado). No cPanel você encontra telas de métricas para acompanhar o uso do seu site ao longo do tempo:

Se notar um pico de acessos ou de processamento no horário em que o erro apareceu, é um bom indício de que foi sobrecarga temporária.

Passo 5 — Ainda não resolveu?

Se você já tentou os passos acima e o site continua apresentando 502 ou 504, é hora de chamar a equipe de suporte da GeHost. Antes de abrir o chamado, ajuda muito se você já tiver anotado:

• Horário aproximado em que o erro começou;
• O que foi feito no site pouco antes disso (mudança, atualização, upload);
• Se o erro é constante ou vai e volta.

Com essas informações, o time consegue investigar muito mais rápido do lado do servidor.

💡 Dica da Sensei: guarde sempre um backup recente do seu site. Assim, se algo der errado depois de uma atualização, dá pra voltar pra uma versão que funcionava enquanto o problema é investigado. Você encontra a área de Backup direto no seu cPanel.

Resumo rápido

1. Atualize a página e limpe o cache;
2. Pense no que mudou recentemente no site;
3. Desative plugins/temas suspeitos pelo Gerenciador de Arquivos;
4. Verifique se houve pico de acessos ou processamento;
5. Se persistir, acione o suporte com os detalhes do que observou.

Combinado assim? Você não precisa ser técnico pra resolver a maioria desses casos — só seguir o passo a passo com calma. E se travar em qualquer etapa, a Sensei e o time da GeHost estão por aqui. 🌸