Como resolver a tela branca da morte (WSOD) Print

Como Resolver a Tela Branca da Morte (WSOD) no WordPress

Oi! Aqui é a Sensei da GeHost 😊. Se você chegou aqui é porque seu site WordPress está exibindo uma tela completamente branca — sem mensagem de erro, sem nada. Relaxa, é mais comum do que você imagina, e a gente resolve isso junto!

O que é a Tela Branca da Morte?

A WSOD (White Screen of Death) acontece quando o WordPress ou um plugin/tema tem um erro grave que o impede de carregar a página. O navegador não mostra nada, só aquele branco assustador. Mas a boa notícia é: geralmente é fácil de arrumar.

Passo 1: Ativar o Modo de Debug

Primeiro, vamos ver qual é exatamente o erro. Para isso, você vai ativar o relatório de erros do WordPress.

1. Entre no painel de controle (cPanel) da sua conta GeHost.
2. Abra o Gerenciador de Arquivos.
3. Procure o arquivo wp-config.php (geralmente na raiz da sua instalação WordPress).
4. Clique com botão direito e escolha Editar (ou abra no editor de texto).
5. Procure pela linha que diz:
   define('WP_DEBUG', false);
6. Mude para:
   define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
7. Salve o arquivo.

Pronto! Agora os erros serão registrados em um arquivo de log, e não aparecerão na tela (o que deixaria seu site estranho).

Passo 2: Procure a Mensagem de Erro

1. No cPanel, abra o Gerenciador de Arquivos novamente.
2. Navegue até a pasta wp-content do seu WordPress.
3. Procure por uma pasta chamada debug.log (pode estar dentro de wp-content).
4. Se encontrar, clique para abrir e leia as mensagens de erro do final para o começo.

Dica: se não encontrar o arquivo debug.log, não se preocupe — vamos aos próximos passos, que resolvem 90% dos casos.

Passo 3: Desativar Todos os Plugins

Na maioria das vezes, a culpa é de um plugin conflitante. Vamos desativar todos eles de uma vez:

1. No cPanel, Gerenciador de Arquivos, navegue até wp-content.
2. Você verá uma pasta chamada plugins.
3. Clique com botão direito em plugins e escolha Renomear.
4. Mude o nome para plugins-desativados (ou qualquer outro nome).
5. Salve.
6. Agora, acesse seu site. Se a tela branca desaparecer, é um plugin que está causando o problema.

Próximo passo: renomeie a pasta de volta para plugins e, um a um, renomeie cada plugin individual (ex.: meu-plugin-desativado) até encontrar o culpado. Quando a tela branca voltar, você achou o plugin problemático.

Passo 4: Cheque o Tema (Template)

Se desativar os plugins não resolveu, o problema pode estar no tema do WordPress:

1. No cPanel, navegue até wp-content → themes.
2. Procure o tema que está ativo (geralmente tem o nome mais comum, tipo "twentytwentyfour" ou similar).
3. Renomeie a pasta do tema para algo como tema-desativado.
4. O WordPress voltará ao tema padrão automaticamente. Acesse seu site.
5. Se a brancura desaparecer, era o tema. Você pode tentar atualizar o tema ou procurar por um novo.

Passo 5: Aumente o Limite de Memória

Às vezes, o WordPress esgota a memória disponível e trava. Vamos aumentar esse limite:

1. Abra o arquivo wp-config.php novamente (mesmo passo de antes).
2. Procure pela linha:
   define('WP_MEMORY_LIMIT', '40M');
3. Mude para:
   define('WP_MEMORY_LIMIT', '256M');
4. Se houver uma linha com WP_MAX_MEMORY_LIMIT, aumente também para 256M.
5. Salve e teste seu site.

Passo 6: Verifique o Arquivo .htaccess

Um arquivo .htaccess corrompido também causa a tela branca. Vamos resetá-lo:

1. No Gerenciador de Arquivos, vá até a raiz do seu WordPress (a pasta principal).
2. Procure pelo arquivo .htaccess (pode estar oculto — ative a opção "Mostrar Arquivos Ocultos" se precisar).
3. Se encontrar, clique para abrir e copie todo o conteúdo (salve em um bloco de notas como backup).
4. Agora, delete o arquivo (ou renomeie para .htaccess-backup).
5. Acesse a área de administração do seu WordPress (em `/wp-admin/`).
6. Vá até Configurações → Permalinks.
7. Clique em Salvar Alterações (sem mudar nada). O WordPress vai criar um novo .htaccess automaticamente.
8. Teste seu site.

Passo 7: Procure por Infecção ou Código Malicioso

Nem sempre a WSOD é um erro simples — às vezes há código malicioso interferindo. Se os passos acima não funcionarem:

1. Procure por arquivos suspeitos ou com nomes estranhos na raiz do seu WordPress (ex.: shell.php, config2.php, base64_decode no código).
2. Se encontrar algo estranho, não delete sozinho — entre em contato com o suporte GeHost. A gente faz a análise de segurança completa.

Quando Pedir Ajuda à GeHost

Se depois de tentar tudo isso a tela branca ainda não sumir, é hora de chamar a gente! Nos procure (e conte o que você já tentou) se:

• A tela branca não desaparece nem após desativar plugins e tema.
• Você encontrou um arquivo suspeito e quer que a gente verifique.
• Você não consegue acessar o cPanel ou o Gerenciador de Arquivos.
• Recebeu uma mensagem de erro estranha e não entende o que é.

Temos um plano de Manutenção Contínua que inclui diagnóstico e suporte técnico completo. Se tiver interesse em proteção contra esses problemas no futuro, a gente conversa sobre isso também! 😊

Dica de Ouro: Faça Backups Regulares

A melhor defesa contra a tela branca é ter um backup recente do seu site. Se tudo der errado, a gente consegue restaurar de um backup em minutos. No cPanel, use a ferramenta de Backup automático — deixa sempre uma cópia guardada.

Qualquer dúvida no caminho, você sabe onde a gente está! Boa sorte lá, e até breve! 💪