Como resolver o erro de tela branca (White Screen of Death) no WordPress
Olá, amigo(a) desenvolvedor(a) ou administrador(a) do seu site! 😊
Se você está diante de uma tela branca ao acessar o seu WordPress — nem mensagem de erro, nem carregamento, só branco — não se preocupe. Esse é um dos problemas mais comuns, mas também um dos mais fáceis de resolver, especialmente com um passo a passo claro. Vamos juntos, como um verdadeiro time de guerra digital? 🛠️Na GeHost, entendemos que o seu site é o coração do seu negócio. Então, vamos te ajudar a trazê-lo de volta à vida com calma, segurança e um toque de paciência. Você não está sozinho(a) — o Sensei está aqui com você!
💡 O que é o White Screen of Death (Tela Branca da Morte)?
É quando o WordPress para de funcionar e exibe apenas uma tela branca. Pode acontecer em qualquer parte do site — na página inicial, no painel de administração, ou mesmo ao tentar fazer login. O erro geralmente vem de um problema no código, plugin ou tema.
Na maioria dos casos, não é um problema do servidor — é algo no seu site. E isso é ótimo, porque significa que podemos resolver!
🔧 Passo a passo para resolver a tela branca
-
Ative o modo de depuração do WordPress
Para entender o que está errado, vamos ativar o modo de depuração. Isso mostra os erros reais no lugar da tela branca.
Para isso, acesse o arquivo
wp-config.phpno seu site. Você pode fazer isso pelo Gerenciador de Arquivos no cPanel.
Localize o arquivo
wp-config.phpdentro da pastapublic_html(ou do subdomínio, se for o caso). -
Edite o arquivo wp-config.php
Abra o arquivo com o editor de texto do cPanel. Procure pela linha:
define('WP_DEBUG', false);Altere para:
define('WP_DEBUG', true);Adicione também estas linhas abaixo, se não existirem:
define('WP_DEBUG_LOG', true);define('WP_DEBUG_DISPLAY', false);Essas configurações vão registrar os erros em um arquivo chamado
wp-content/debug.log— sem mostrar erros na tela (evitando mais brancos). -
Recarregue o site
Salve as alterações e recarregue a página do seu site (ou do painel admin:
seudominio.com/wp-admin).Se o erro ainda aparecer, a tela branca pode estar ocultando o problema. Mas agora, o erro está sendo salvo no arquivo
debug.log. -
Verifique o arquivo de log
Volte ao Gerenciador de Arquivos e acesse a pasta
wp-content. Lá, você encontrará um arquivo chamadodebug.log.Abra esse arquivo e procure por mensagens como:
PHP Parse errorCall to undefined functionCannot redeclareWarning: require()
Essas mensagens mostram exatamente onde está o problema — geralmente em um plugin ou no tema.
-
Desative plugins (um por um)
Se o erro for causado por um plugin, vamos desativá-los temporariamente.
Use o Gerenciador de Arquivos para ir até a pasta
wp-content/plugins.Renomeie a pasta de um plugin (ex:
nome-do-plugin→nome-do-plugin-DESATIVADO). Isso desativa o plugin.Recarregue o site. Se o erro desaparecer, o problema era esse plugin. Você pode reativar os outros um a um até encontrar o culpado.
-
Desative o tema atual
Se o erro persistir, pode ser o tema. Vá até
wp-content/themesno Gerenciador de Arquivos.Renomeie a pasta do tema que você está usando (ex:
meutema→meutema-DESATIVADO).O WordPress automaticamente volta para o tema padrão (como
Twenty Twenty-Four).Recarregue o site. Se funcionar, o problema é no seu tema. Pode ser um arquivo corrompido ou código inválido.
-
Reactive o modo de depuração (opcional)
Depois de resolver, volte ao
wp-config.phpe volte para:define('WP_DEBUG', false);Isso mantém o site seguro e sem mostrar erros para os visitantes.
💡 Dicas do Sensei da GeHost
- Backup sempre! Antes de editar qualquer arquivo, faça um backup completo da sua conta no cPanel. Use a ferramenta Backup (em
Backupno cPanel). - Não edite arquivos diretamente se não souber o que está fazendo. Um erro de sintaxe pode piorar tudo.
- Plugins e temas são responsáveis por 90% dos erros. Sempre atualize apenas os de confiança e de fontes oficiais.
- Se não conseguir resolver, entre em contato com o suporte da GeHost — estamos aqui para ajudar. Use o painel do cliente em painel.gehost.com.br.
🔐 Sobre a GeHost
Estamos aqui para garantir que seu site funcione com tranquilidade. Com mais de 8 anos de experiência, o grupo G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04), sob a liderança de Raphael Neves Koga, entrega hospedagem segura, estável e com suporte humano — porque tecnologia sem alma é só código.
Se precisar de ajuda, lembre-se: 30 dias grátis após a entrega estão sempre disponíveis para você — não hesite em nos chamar.
Seu site é importante. E você, também. 💚