WordPress 33 visualizações

Como identificar qual plugin está quebrando o site depois de uma atualização

Ver no WHMCS

Como identificar qual plugin está quebrando o site depois de uma atualização

Oi! Eu sou a Sensei da GeHost, e vou te guiar com calma por esse probleminha clássico do WordPress: você (ou o WordPress) atualizou um ou mais plugins, e agora o site está com tela branca, erro estranho ou algo "quebrado". Respira — isso tem solução, e na maioria das vezes é rapidinho de resolver. Vamos passo a passo. 💙

Dica de ouro: nunca teste essas mudanças direto no site que seus clientes estão vendo, se puder evitar. Se você tiver um horário de menor movimento, prefira fazer por ali. E sempre que for "brincar" com plugins, faça antes um backup — no cPanel existe a área de Backup justamente para isso.

Tela de Backup do cPanel com opções de backup completo e parcial

Passo 1: Confirme que o problema é mesmo de plugin

Antes de sair desativando tudo, vale confirmar a origem. Alguns sinais de que é plugin (e não tema ou hospedagem):

  • O problema começou logo depois de uma atualização de plugin (você recebeu e-mail de atualização, ou viu no painel do WordPress).
  • Aparece uma mensagem de erro citando um caminho como wp-content/plugins/nome-do-plugin/....
  • Uma função específica do site parou (ex: formulário de contato, galeria, loja) em vez do site inteiro cair.

Passo 2: Se você ainda consegue acessar o wp-admin

Esse é o caminho mais fácil. Siga assim:

  1. Entre em wp-admin → Plugins.
  2. Selecione todos os plugins e escolha a ação em massa "Desativar".
  3. Veja se o site voltou ao normal. Se sim, confirmado: é plugin.
  4. Agora vá reativando um plugin por vez, testando o site depois de cada reativação.
  5. Quando o problema reaparecer, pronto — você encontrou o culpado! 🎯
Dica: anote a ordem em que você reativa os plugins numa notinha (bloco de notas mesmo). Isso evita reativar o mesmo duas vezes ou perder a linha de raciocínio no meio do processo.

Passo 3: Se o site está com tela branca e você NÃO consegue entrar no wp-admin

Sem pânico — dá pra desativar plugins mesmo sem acessar o painel, direto pelos arquivos do site, usando o Gerenciador de Arquivos do cPanel:

  1. Acesse o cPanel e abra o Gerenciador de Arquivos.
  2. Navegue até a pasta do seu site, geralmente dentro de public_html, e depois wp-content/plugins.
  3. Renomeie a pasta plugins inteira para algo como plugins-teste (isso desativa todos os plugins de uma vez, sem apagar nada).
  4. Teste o site. Se voltar ao ar, o problema é mesmo de plugin.
  5. Renomeie a pasta de volta para plugins.
  6. Agora, dentro da pasta plugins, renomeie uma subpasta de plugin por vez (ex: de contact-form-x para contact-form-x-teste) e teste o site a cada tentativa, até achar o culpado.
Gerenciador de Arquivos do cPanel mostrando a árvore de pastas

Passo 4: Depois de encontrar o plugin culpado

Encontrou? Ótimo, agora você tem algumas opções:

  • Atualize o plugin de novo — as vezes o próprio autor já lançou uma correção logo depois.
  • Volte para a versão anterior do plugin, se você tiver um backup dela ou se o autor disponibilizar versões antigas.
  • Procure um plugin alternativo que faça a mesma função, caso esse não tenha mais suporte do desenvolvedor.
  • Fale com o suporte do plugin (muitos têm fórum ou canal de ajuda) explicando o erro encontrado.

Passo 5: Confira o log de erros para mais detalhes

Se quiser ir além e entender exatamente o que aconteceu, o WordPress guarda um registro de erros. Você pode habilitar o modo debug editando o arquivo wp-config.php (pelo mesmo Gerenciador de Arquivos) e adicionando a linha:

define('WP_DEBUG', true);

Isso vai mostrar mensagens de erro mais detalhadas na tela ou registrar em um arquivo de log, ajudando a confirmar qual plugin está causando o problema. Depois de resolver, não esqueça de voltar essa linha para false — deixar ativada expõe informações do site para qualquer visitante.

Prevenindo isso no futuro

  • Sempre faça um backup antes de atualizar plugins importantes.
  • Evite atualizar todos os plugins de uma vez só, se o site for algo crítico — atualize em pequenos grupos.
  • Mantenha poucos plugins instalados: cada plugin extra é um risco extra de conflito.
Ficou travado em algum passo? Sem problemas — nossa equipe de suporte está aqui pra te ajudar. Você pode conferir os detalhes do seu plano e abrir um chamado direto pelo painel.gehost.com.br. 💙

Espero que esse guia tenha ajudado! Sempre que precisar, é só voltar aqui. Um abraço da sua Sensei da GeHost. 🌱

Precisa de Ajuda?

Nossa equipe está pronta para resolver suas dúvidas.