Como usar o modo de depuração (WP_DEBUG) para descobrir qual plugin está dando problema
Olá! Aqui é a Sensei da GeHost 🥋. Se o seu site WordPress apresentou uma tela branca, um erro estranho ou aquele aviso de "erro crítico", respira fundo: na grande maioria das vezes o culpado é um plugin (ou tema) que não está se dando bem com alguma atualização. Neste guia vou te ensinar, passo a passo, a ativar o modo de depuração do WordPress (WP_DEBUG) para descobrir exatamente qual plugin está causando o erro — sem complicação e sem precisar ser programador.
Dica da Sensei: pense no WP_DEBUG como uma "lanterna" que o WordPress acende para você. Ele não conserta nada sozinho, mas mostra exatamente onde está o problema.
O que é o WP_DEBUG?
O WordPress tem um modo especial que, quando ativado, passa a registrar (anotar) todos os avisos, erros e alertas que acontecem nos bastidores do site. Normalmente esses avisos ficam escondidos para não assustar os visitantes, mas para nós, que estamos investigando um problema, eles são ouro puro.
Passo 1 — Faça um backup antes de tudo
Antes de mexer em qualquer arquivo, é sempre mais seguro ter uma cópia de segurança recente do site. No cPanel você encontra essa opção na tela de Backup.
Passo 2 — Acesse o arquivo wp-config.php
O arquivo wp-config.php é o "painel de controle" do seu WordPress e é nele que vamos ligar a lanterna do debug. Para chegar até ele:
- Acesse o cPanel da sua hospedagem (você encontra o link e os dados de acesso no seu painel.gehost.com.br).
- Entre na ferramenta Gerenciador de Arquivos.
- Abra a pasta public_html (ou a subpasta onde o WordPress está instalado).
- Localize o arquivo wp-config.php, clique com o botão direito nele e escolha Editar.
Passo 3 — Ative o modo de depuração
Dentro do arquivo, procure pela seguinte linha (geralmente próxima ao final):
define( 'WP_DEBUG', false );
Troque false por true, ficando assim:
define( 'WP_DEBUG', true );
Para que os erros sejam salvos em um arquivo (e não apareçam na tela, o que pode assustar seus visitantes), adicione logo abaixo estas duas linhas:
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Depois, clique em Salvar Alterações.
Dica da Sensei: com WP_DEBUG_DISPLAY como false, os erros não aparecem na tela para quem visita o site — eles ficam guardadinhos em um arquivo de log, só para você ver. Assim ninguém mais percebe que algo está sendo investigado.
Passo 4 — Reproduza o erro e leia o log
Agora navegue pelo site (ou faça a ação que estava dando erro) para que o problema aconteça de novo. O WordPress vai anotar tudo em um novo arquivo chamado:
/wp-content/debug.log
Volte ao Gerenciador de Arquivos, entre na pasta wp-content e abra o arquivo debug.log para visualizar as anotações. Procure por linhas que mencionem a pasta /wp-content/plugins/ seguida do nome de um plugin — esse é o principal suspeito!
Passo 5 — Confirme o culpado desativando plugins um a um
Encontrar o nome do plugin no log já ajuda bastante, mas para ter certeza absoluta, o método mais confiável é:
- Vá até o painel administrativo do WordPress (wp-admin) e acesse Plugins.
- Desative todos os plugins de uma vez (não se preocupe, isso não apaga nada, apenas os pausa).
- Veja se o erro sumiu. Se sim, o problema é mesmo de algum plugin.
- Ative os plugins um por um, testando o site a cada ativação, até o erro voltar a aparecer.
- O último plugin ativado antes do erro reaparecer é o responsável.
Dica da Sensei: se o site ficar inacessível e você não conseguir nem entrar no wp-admin, dá para desativar os plugins diretamente pelo Gerenciador de Arquivos: renomeie a pasta /wp-content/plugins para algo como plugins_old. Isso desativa todos de uma vez. Depois, renomeie de volta para plugins e vá renomeando as pastas de cada plugin individualmente para testar um por vez.
Passo 6 — Resolva e desligue o modo de depuração
Depois de identificar o plugin problemático, você pode:
- Atualizar o plugin para a versão mais recente (muitas vezes o problema já foi corrigido pelo desenvolvedor);
- Trocar por um plugin similar, caso ele esteja abandonado;
- Entrar em contato com o suporte do plugin, se o problema persistir.
Por fim, não esqueça de desligar o modo de depuração voltando a linha no wp-config.php para:
define( 'WP_DEBUG', false );
Isso é importante porque manter o debug ligado deixa o arquivo de log crescendo sem parar e pode expor informações técnicas do site desnecessariamente.
Ficou com dúvida em algum passo?
Sem problemas! Se você preferir, nossa equipe de suporte pode te ajudar a investigar o erro. Basta abrir um chamado pelo seu painel em painel.gehost.com.br que vamos te dar uma força. Você não está sozinho nessa jornada! 🌱