Tela Branca no WordPress: O Que Causa e Como Resolver

Você tenta acessar o seu site e encontra uma página completamente em branco. Sem mensagem de erro, sem pista do que aconteceu. Apenas o nada.

Esse problema é tão comum no WordPress que ganhou nome próprio: White Screen of Death (WSOD) , ou, em bom português, a Tela Branca da Morte.

Apesar do nome dramático, a WSOD tem solução. Neste artigo, vamos explicar o que causa esse problema e como resolvê-lo passo a passo.

Este artigo faz parte do nosso Guia Completo de Erros WordPress .

O Que é a Tela Branca da Morte (WSOD)?

A tela branca acontece quando o PHP encontra um erro fatal mas não tem permissão para exibir mensagens de erro na tela. O resultado é uma página completamente vazia.

Em versões mais recentes do WordPress (5.2+), a WSOD foi parcialmente substituída pela mensagem "Houve um erro crítico no seu site", mas muitos servidores ainda exibem a tela branca pura, especialmente quando o erro acontece antes do WordPress carregar completamente.

Variantes da tela branca

Site inteiro em branco: tanto o front-end quanto o wp-admin
Apenas o front-end em branco: o wp-admin funciona normalmente (problema no tema)
Apenas o wp-admin em branco: o site funciona (problema em plugin que age no admin)
Tela branca após atualização: plugin, tema ou WordPress core

Causas Mais Comuns

Plugin com erro fatal , causa mais frequente
Tema com código incompatível ou corrompido
Limite de memória PHP insuficiente
Erro de sintaxe em arquivo editado manualmente (functions.php, wp-config.php)
Versão de PHP incompatível com plugin ou tema
Atualização interrompida do WordPress core

Passo 1: Ative o Modo Debug

O primeiro passo é fazer o WordPress mostrar o que está acontecendo de errado. Para isso, vamos ativar o modo debug.

Como ativar

Acesse os arquivos do site via FTP ou gerenciador de arquivos
Abra o arquivo wp-config.php
Encontre a linha define('WP_DEBUG', false);
Substitua por:

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

Salve e acesse o site novamente

Agora, em vez da tela branca, você deve ver uma mensagem de erro detalhada indicando o arquivo e a linha onde o problema ocorre.

Lendo o erro

Uma mensagem típica de erro fatal:

Fatal error: Allowed memory size of 67108864 bytes exhausted in /home/usuario/public_html/wp-includes/class-wpdb.php on line 2154

Essa mensagem indica:

Tipo: Fatal error (erro fatal)
Causa: Memória esgotada (67108864 bytes = 64MB)
Arquivo: class-wpdb.php, linha 2154

Com essa informação, você sabe exatamente o que corrigir.

Após resolver o problema, desative o debug para não expor informações sensíveis:

define('WP_DEBUG', false);

Passo 2: Aumente o Limite de Memória PHP

Se o erro indicar memória esgotada ("Allowed memory size exhausted"), a solução é aumentar o limite.

Via wp-config.php

Adicione antes da linha /* That's all, stop editing! */ :

define('WP_MEMORY_LIMIT', '256M');

Via php.ini

Se tiver acesso ao php.ini :

memory_limit = 256M

Se o limite de memória for a causa, o site voltará a funcionar imediatamente após o aumento.

Porém, se o site consumir mais de 256MB de memória, pode haver um memory leak em algum plugin ou tema. Nesse caso, é necessário investigar a causa raiz.

Passo 3: Desative Plugins via FTP

Se a tela branca apareceu após instalar ou atualizar um plugin, a causa provável é um conflito.

Como desativar sem acesso ao painel

Acesse o site via FTP
Navegue até /wp-content/
Renomeie a pasta plugins para plugins_off
Acesse o site

Se o site voltar, um dos plugins é o causador.

Encontrando o plugin problemático

Renomeie plugins_off de volta para plugins
Dentro de plugins , renomeie cada pasta de plugin individualmente (ex: woocommerce para woocommerce_off )
Acesse o site após renomear cada um
Quando o site quebrar de novo, você encontrou o vilão

O que fazer com o plugin problemático

Atualize para a versão mais recente
Verifique se é compatível com sua versão do WordPress e PHP
Procure alternativas se o plugin estiver abandonado (sem atualização há mais de 6 meses)
Reporte o bug ao desenvolvedor

Passo 4: Troque o Tema via FTP

Se desativar os plugins não resolveu, o problema pode estar no tema, especialmente se a tela branca apareceu após trocar ou atualizar o tema.

Como trocar

Via FTP, navegue até /wp-content/themes/
Renomeie a pasta do tema ativo (ex: flavor para flavor_off )
Certifique-se de que existe um tema padrão do WordPress instalado (twentytwentyfour, twentytwentythree, etc.)
O WordPress ativará automaticamente o tema padrão

Se não tiver tema padrão instalado

Baixe o Twenty Twenty-Four em wordpress.org/themes
Extraia e faça upload da pasta twentytwentyfour para /wp-content/themes/
Renomeie o tema atual conforme descrito acima

Passo 5: Verifique Erros de Sintaxe

Se você editou manualmente algum arquivo PHP (como functions.php ou wp-config.php ) e a tela branca apareceu em seguida, provavelmente há um erro de sintaxe.

Erros comuns de sintaxe

Falta de ponto e vírgula ( ; ) no final de uma linha
Aspas não fechadas
Chaves {} ou parênteses () desbalanceados
Vírgula extra no final de um array

Como corrigir

Acesse o arquivo via FTP
Revise a última alteração feita
Corrija o erro ou reverta para a versão anterior (se tiver backup)

Se não lembrar o que alterou, verifique o log de erros. Com WP_DEBUG_LOG ativado, o arquivo /wp-content/debug.log indicará a linha exata do erro.

Passo 6: Verifique a Versão do PHP

Temas e plugins modernos exigem PHP 7.4 ou superior. Se o servidor estiver rodando PHP 7.2 ou inferior, você pode encontrar a tela branca.

Como verificar

No painel da hospedagem, procure por "Selecionar versão PHP" ou "PHP Version"
Verifique a versão atual
Se for inferior a 7.4, atualize para PHP 8.1 ou 8.2

Cuidado ao atualizar PHP

Alguns plugins antigos não funcionam com PHP 8.x. Se a tela branca aparecer após atualizar o PHP:

Reverta para a versão anterior de PHP
Ative o debug para identificar o plugin incompatível
Atualize ou substitua o plugin
Tente atualizar o PHP novamente

Passo 7: Reinstale o WordPress Core

Se nenhuma das soluções anteriores funcionou, os arquivos do WordPress podem estar corrompidos, especialmente após uma atualização interrompida.

Baixe o WordPress mais recente em br.wordpress.org
Extraia o ZIP
Via FTP, substitua as pastas wp-admin e wp-includes inteiras
Substitua os arquivos PHP da raiz (exceto wp-config.php )
Nunca substitua a pasta wp-content

Como Prevenir a Tela Branca

Mantenha backups diários , tanto dos arquivos quanto do banco de dados
Atualize em ambiente de staging antes de aplicar no site de produção
Nunca edite arquivos PHP pelo editor do WordPress. Use um editor de código local
Monitore o uso de memória do site
Mantenha o PHP atualizado na versão mais recente estável
Use apenas plugins e temas de fontes confiáveis

Quando Chamar um Especialista

A tela branca pode parecer simples, mas em alguns casos envolve problemas mais profundos: banco de dados corrompido, arquivos infectados por malware, ou conflitos no nível do servidor.

Se você já seguiu todos os passos acima e a tela branca persiste, ou se não se sente confortável editando arquivos do servidor, a HOSTWP pode ajudar. Nosso suporte especializado em WordPress cobre do servidor ao site. Identificamos e resolvemos o problema sem você precisar se preocupar com nada técnico. Fale com a HOSTWP .