Erro: tela branca (White Screen of Death) no WordPress — como resolver Print

Erro: Tela Branca no WordPress — Como Resolver (Guia para Iniciantes)

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

Se você está vendo uma tela branca ao tentar acessar seu site WordPress, não se preocupe — isso é mais comum do que parece e, na maioria das vezes, tem solução simples. Você não está sozinho(a), e eu, seu Sensei da GeHost, estou aqui para te ajudar passo a passo.

Esse erro, conhecido como White Screen of Death (Tela Branca da Morte), geralmente acontece por problemas de código, plugins conflitantes, ou erros de configuração. Vamos resolver isso juntos, com calma e segurança.

Passo 1: Verifique se o problema está no seu site ou no seu navegador

Antes de tudo, confirme se o erro está realmente no seu site e não em seu navegador:

• Tente acessar o site em outro dispositivo (celular, tablet, outro computador).
• Tente abrir o site em modo anônimo (ou incógnito) do navegador.
• Se o erro desaparecer em outro dispositivo ou modo, o problema é local — talvez cache ou extensão do navegador.

Dica do Sensei: Às vezes, uma extensão maliciosa ou um cache corrompido pode causar esse problema. Limpe o cache do navegador ou teste em outro dispositivo.

Passo 2: Ative o modo de depuração do WordPress

Esse é o passo mais importante para descobrir por que a tela branca está aparecendo.

Para ativar o modo de depuração, vamos editar um arquivo do WordPress chamado wp-config.php. Ele está na raiz do seu site (dentro da pasta public_html).

Para isso, vamos usar o Gerenciador de Arquivos do cPanel:

1. Entre no seu cPanel (acesse via seusite.com.br/cpanel).
2. Na tela inicial do cPanel, clique em Gerenciador de Arquivos (File Manager).
3. Selecione a pasta public_html (ou o nome da sua pasta principal do site).
4. Localize o arquivo wp-config.php na lista de arquivos.
5. Clique com o botão direito no arquivo e escolha Editar.

Após abrir o arquivo, procure pela linha:

define('WP_DEBUG', false);

Altere para:

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

Salve as alterações (clique em Salvar ou Salvar Arquivo).

Dica do Sensei: Essas configurações vão mostrar erros no WordPress sem exibi-los na tela — evitando mais telas brancas. Os erros serão gravados em um arquivo chamado debug.log dentro da pasta wp-content.

Passo 3: Acesse seu site novamente e veja o erro

Volte ao seu site e recarregue a página. Agora, em vez de uma tela branca, você deve ver uma mensagem de erro (como “Parse error”, “Fatal error” ou “Call to undefined function”) — isso é super útil!

Se aparecer um erro, anote exatamente o que está escrito. Ele pode indicar qual plugin, tema ou arquivo está causando o problema.

Passo 4: Desative plugins e temas (passo a passo seguro)

Se o erro não aparecer após ativar o modo de depuração, ou se o erro for difícil de entender, vamos desativar os plugins e o tema para testar.

Para isso, vamos usar o Gerenciador de Arquivos novamente:

1. Volte ao Gerenciador de Arquivos do cPanel.
2. Navegue até a pasta wp-content.
3. Encontre a pasta plugins.
4. Rename (mude o nome) da pasta plugins para plugins_backup.
5. Depois, vá até a pasta themes e renomeie a pasta do seu tema atual (ex: twentynineteen) para tema_atual_backup.

Essa ação desativa todos os plugins e o tema atual. Ao recarregar o site, o WordPress vai usar o tema padrão (como Twenty Twenty-Four).

Se o site voltar a funcionar, significa que o problema estava em um plugin ou no tema.

Passo 5: Identifique o culpado

Se o site voltou a funcionar:

• Recoloque a pasta plugins_backup para plugins (para reativar todos os plugins).
• Entre no WordPress (via seusite.com.br/wp-admin) e vá para Plugins.
• Desative um plugin por vez, recarregando o site após cada desativação.
• Quando o erro voltar, você encontrou o culpado — desative-o permanentemente ou entre em contato com o desenvolvedor.

Se o problema persistir mesmo com os plugins desativados, o problema está no tema. Nesse caso, use um tema padrão (como Twenty Twenty-Four) e teste novamente.

Passo 6: Reverta as alterações (para segurança)

Quando o problema estiver resolvido:

• Volte ao Gerenciador de Arquivos.
• Renomeie a pasta plugins_backup de volta para plugins.
• Renomeie a pasta do tema de volta para o nome original.
• Volte ao arquivo wp-config.php e altere as linhas de depuração de volta para:

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

Salve o arquivo. Isso garante que erros não sejam exibidos publicamente.

Quer ajuda extra? Estamos aqui!

Se você seguiu todos os passos e ainda não conseguiu resolver, não se preocupe — nós da GeHost estamos aqui para te ajudar.

Entre em contato com nosso suporte via atendimento.gehost.com.br ou pelo chat no cPanel. Envie-nos o conteúdo do arquivo wp-content/debug.log (ele aparece após ativar o modo de depuração).

Se precisar, podemos acessar seu site com segurança para ajudar — sem risco de perder seus dados.

Está tudo bem. Erros acontecem. O importante é saber que você não está sozinho(a), e com paciência, atenção e um bom guia, tudo volta ao normal. 🌿

Com carinho,
Seu Sensei da GeHost 💙