Como saber qual plugin está causando a tela branca da morte (WSOD) no WordPress
Olá, querido(a) cliente da GeHost! Se você está com a famosa “tela branca da morte” no seu WordPress — aquela tela em branco quando tenta acessar o site ou o painel — não se preocupe. Isso é comum, e muitas vezes é causado por um plugin com erro de código. Vamos juntos resolver isso, passo a passo, com calma e certeza. Você não está sozinho(a) nessa!
Sensei diz: "A tela branca não é um monstro. É um sinal. E quando você ouve o sinal com atenção, ele te leva à solução."
Passo 1: Ativar o modo de depuração do WordPress
Antes de tudo, vamos deixar o WordPress nos mostrar o que está errado. Para isso, precisamos ativar o modo de depuração. Isso vai mostrar mensagens de erro que nos ajudam a identificar o culpado.
- Entre no cPanel da sua conta na GeHost. Você pode acessar pelo painel.gehost.com.br.
- Na seção Arquivos, clique em Gerenciador de Arquivos.
- Na lista de pastas, clique em public_html (ou a pasta onde seu site está).
- Localize o arquivo chamado wp-config.php. Clique nele e selecione Editar.
Em seguida, procure a linha que diz:
define('WP_DEBUG', false);Substitua por:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);Salve as alterações. Agora, ao tentar acessar o site ou o painel do WordPress, em vez da tela branca, você verá uma mensagem de erro — e essa mensagem vai nos dizer exatamente qual plugin está causando o problema.
Passo 2: Verifique o arquivo de log de erros
O WordPress está agora gravando os erros no arquivo debug.log. Vamos localizar esse arquivo:
- No Gerenciador de Arquivos, na pasta public_html, procure por um arquivo chamado debug.log.
- Clique nele e selecione Editar.
Procure por uma linha que diga algo como:
Plugin 'nome-do-plugin' caused a fatal error.Essa é a pista! Anote o nome do plugin que aparece no log. É o culpado.
Passo 3: Desative plugins um por um (método de eliminação)
Se o log não mostrar o nome do plugin, ou se você quiser confirmar, podemos usar o método clássico: desativar os plugins um a um.
- Entre no painel do WordPress (ex: seu-site.com/wp-admin).
- Se não conseguir acessar, vá até o cPanel e vá em Gerenciador de Arquivos.
- Entre na pasta wp-content e depois em plugins.
- Renomeie a pasta de um plugin (ex: nome-do-plugin) para nome-do-plugin.deativado.
- Tente acessar o site novamente. Se funcionar, o plugin que você renomeou era o problema.
- Se ainda der tela branca, renomeie outro plugin e repita o processo.
Sensei diz: "A paciência é a chave. Cada renomeação é um passo mais perto da verdade. Não se apresse. O erro vai se revelar."
Passo 4: Reative o plugin corrigido ou atualize-o
Quando encontrar o plugin causador do problema:
- Se for um plugin que você não usa, pode removê-lo permanentemente.
- Se for um plugin importante, verifique se há uma atualização disponível. Às vezes, o erro é corrigido em versões mais novas.
- Se o plugin não está mais sendo atualizado, considere substituí-lo por outro alternativo.
Passo 5: Desative o modo de depuração
Depois de resolver o problema, lembre-se de desativar o modo de depuração para segurança e desempenho:
- Volte ao arquivo wp-config.php.
- Volte a definir:
define('WP_DEBUG', false); - Salve o arquivo.
Pronto! Seu site está de volta, seguro e funcionando. E você aprendeu um novo truque com o WordPress.
Dica extra: sempre faça backup antes de mexer
Antes de desativar plugins ou editar arquivos, faça um backup da sua conta. No cPanel, vá em Backup e gere um Backup Completo. Assim, se algo der errado, você pode voltar ao ponto anterior.
Quer ajuda extra?
Se mesmo após todos os passos o problema persistir, entre em contato com o nosso suporte. Estamos aqui para te ajudar, com carinho e dedicação.
Seu site é importante. E você, querido cliente, é muito mais do que um número — é parte da nossa história.
Com carinho,
Sensei da GeHost
*Grupo G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)*