Como diagnosticar problema de branco (white screen) no WordPress Print

Como Diagnosticar e Resolver o Problema do Branco no WordPress

Olá, amigo(a) GeHost! Se você está vendo uma tela branca ao acessar seu site WordPress, não se preocupe — isso é mais comum do que parece e, na maioria das vezes, tem solução simples. Como seu Sensei da GeHost, vou te guiar passo a passo com calma, clareza e um toque de paciência. Vamos juntos?

🔍 O que é a tela branca no WordPress?

É quando, ao abrir seu site, aparece apenas uma página em branco — sem erros, sem mensagens, nada. Isso geralmente acontece devido a um erro no código, um plugin mal instalado, ou um problema com a configuração do servidor.

Dica do Sensei: Antes de pular para soluções complexas, verifique se o problema está no seu navegador. Tente acessar o site em outro dispositivo ou em modo anônimo (Ctrl+Shift+N no Chrome).

🛠️ Passo a Passo para Diagnosticar o Problema

1. Verifique se o site está realmente offline

   Abra seu site em outro navegador ou dispositivo. Se ainda está em branco, o problema está no servidor, não no seu computador.

2. Ative o modo de depuração do WordPress

   Isso permite que o WordPress mostre erros em vez de apenas uma tela branca. Para isso, precisamos acessar o arquivo wp-config.php no seu site.

   Use o Gerenciador de Arquivos do cPanel para localizar o arquivo:

   

   Abra o arquivo wp-config.php com o editor de texto do cPanel.

3. Adicione as linhas de depuração

   Procure pela linha que diz:

   define('WP_DEBUG', false);

   Substitua por:

   define('WP_DEBUG', true);
   define('WP_DEBUG_LOG', true);
   define('WP_DEBUG_DISPLAY', false);

   Salve o arquivo.

4. Recarregue o site

   Volte ao seu site e veja o que aparece. Agora, em vez de uma tela branca, você verá uma mensagem de erro (como "Fatal error: Uncaught Error...") que nos diz exatamente onde está o problema.

5. Verifique o arquivo de log

   Depois de ativar o modo de depuração, o WordPress cria um arquivo chamado wp-content/debug.log.

   Volte ao Gerenciador de Arquivos e procure por esse arquivo dentro da pasta wp-content.

   Abra o arquivo e veja qual erro está sendo registrado. Ele pode indicar um plugin, tema ou arquivo com erro de sintaxe.

6. Desative plugins e temas (em ordem)

   Se o erro não aparecer, o problema pode estar em um plugin ou tema. Para testar:

   • Renomeie a pasta plugins dentro de wp-content para plugins.bak.
   • Se o site voltar a funcionar, o problema está em um plugin. Renomeie a pasta de volta e renomeie cada plugin individualmente para identificar o culpado.
   • Se o site ainda estiver branco, o problema pode estar no tema. Renomeie a pasta do tema atual (ex: twentytwentyfour) para twentytwentyfour.bak e veja se o site volta a funcionar.
7. Restaure o arquivo original

   Depois de identificar o problema, volte ao arquivo wp-config.php e troque de volta para:

   define('WP_DEBUG', false);

   Isso evita que erros sejam exibidos publicamente no futuro.

💡 Dicas Finais do Sensei

• Antes de fazer alterações, faça um backup da sua conta no cPanel. Isso é como guardar uma cópia de segurança do seu site.
• Nunca altere arquivos do WordPress sem saber o que está fazendo. Se tiver dúvidas, chame a nossa equipe — estamos aqui para te ajudar.
• Se o problema persistir mesmo após desativar plugins e temas, pode ser um erro no servidor. Nesse caso, envie o arquivo debug.log para nosso suporte técnico.

Leve em conta: Tela branca não é um desastre. É um sinal. E você, com um pouco de paciência, já está no caminho certo. Você é capaz!

Se precisar de ajuda, é só chamar a GeHost. Estamos aqui com você, sempre.