Como resolver o erro 'Tela Branca da Morte' (White Screen of Death) no WordPress

Como resolver o erro 'Tela Branca da Morte' (White Screen of Death) no WordPress

Olá, querido(a) cliente da GeHost! 👋

Se você está vendo uma tela completamente branca ao acessar seu site WordPress — sem erros, sem mensagens, apenas branco — não se preocupe. Esse problema, conhecido como "Tela Branca da Morte" (White Screen of Death), é comum, mas tem solução. E o melhor: muitas vezes, você mesmo pode resolver com alguns passos simples.

Aqui, vou te guiar com calma, como um verdadeiro Sensei da GeHost, passo a passo, com linguagem fácil e sem enrolação. Vamos juntos?

📌 Primeiro: entenda o que está acontecendo

A "Tela Branca da Morte" geralmente acontece quando o WordPress encontra um erro crítico durante o carregamento — como um plugin com erro, um tema corrompido ou um problema de configuração no arquivo wp-config.php. O sistema para de funcionar e só mostra branco. Mas não é o fim do mundo. Vamos resolver isso!

🔧 Passo a passo: como consertar a Tela Branca

1. Ative o modo de depuração do WordPress
   Isso vai mostrar o erro real, ajudando a identificar a causa. Para isso, vamos acessar os arquivos do seu site pelo Gerenciador de Arquivos do cPanel.

2. Localize o arquivo wp-config.php
   No painel do Gerenciador de Arquivos, vá até a pasta public_html (ou a pasta onde seu site está instalado). Procure pelo arquivo chamado wp-config.php.
3. Edite o arquivo
   Clique com o botão direito no arquivo wp-config.php e selecione Editar (ou "Editar com o Editor de Texto").
4. Adicione estas linhas no final do arquivo
   No final do arquivo, antes da linha que diz /* That's all, stop editing! Happy blogging. */, insira estas linhas:

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

   Esse código ativa o modo de depuração, mas não mostra erros na tela — evita que o branco fique pior. Os erros serão salvos em um arquivo chamado wp-content/debug.log.

5. Salve as alterações
   Clique em Salvar (ou "Salvar Arquivo").
6. Recarregue seu site
   Volte para o navegador e recarregue a página do seu site. Agora, se houver um erro, ele será registrado no arquivo de log.
7. Verifique o arquivo de erro
   Volte ao Gerenciador de Arquivos e vá até a pasta wp-content. Lá, você verá um arquivo chamado debug.log. Abra-o e veja qual é o erro.

   Exemplo comum: Plugin 'nome-do-plugin' caused a fatal error ou Call to undefined function. Isso te mostra exatamente qual parte está falhando.

8. Desative o plugin ou tema problemático
   Com o erro identificado, você pode resolver de duas formas:
   • Se for um plugin: Acesse a pasta wp-content/plugins e renomeie a pasta do plugin com erro (ex: nome-do-plugin → nome-do-plugin.bak). Isso desativa o plugin.
   • Se for o tema: Acesse wp-content/themes e renomeie a pasta do tema atual (ex: tema-atual → tema-atual.bak). O WordPress volta para o tema padrão (como "Twenty Twenty-Four").
9. Recarregue o site
   Após desativar o plugin ou tema, recarregue o site. Ele deve voltar a funcionar!
10. Reinstale o plugin ou tema com cuidado
    Se o problema foi um plugin ou tema, baixe uma versão limpa do arquivo (do site oficial) e reinstale. Evite plugins ou temas de fontes desconhecidas.
11. Desative o modo de depuração
    Após resolver, volte ao arquivo wp-config.php e remova ou comente as linhas que adicionamos:

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

    Salve o arquivo. Isso mantém seu site seguro e sem informações sensíveis visíveis.

💡 Dicas extras do Sensei da GeHost

• Se não conseguir acessar o painel do WordPress, use o cPanel para editar os arquivos. É seguro e fácil.
• Se o erro persistir mesmo após desativar plugins e temas, pode ser um problema no wp-config.php ou no banco de dados. Nesse caso, entre em contato com o suporte da GeHost — estamos aqui para te ajudar!
• Nunca edite arquivos do WordPress sem fazer um backup. Você pode usar o Backup no cPanel para salvar sua conta antes de qualquer alteração.
• Se precisar de ajuda, o suporte da GeHost está disponível por 30 dias após a entrega. Acesse o Painel do Cliente e abra um chamado.

📌 Resumo rápido

1. Ative o modo de depuração no wp-config.php.
2. Veja o erro no arquivo debug.log.
3. Desative o plugin ou tema com problema.
4. Recarregue o site — ele deve voltar a funcionar.
5. Remova o modo de depuração após resolver.

Se tudo falhar, não se esqueça: você tem um suporte de verdade da GeHost. Eles são do grupo G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04), com Raphael Neves Koga à frente desde 2015. Estamos aqui para te ajudar, com carinho e dedicação.

Seu site vai voltar a brilhar — com ou sem branco. 😉