Tela branca da morte no WordPress: o que é e como resolver

Atualizado em 19/06/2026

A "tela branca da morte" — em inglês, White Screen of Death ou WSOD — é um dos sustos clássicos do WordPress: você acessa o site e, em vez de página ou erro, vê apenas uma tela completamente em branco. Sem layout, sem texto, sem código de erro. O nome assusta, mas o problema quase sempre tem causa identificável e solução sem perda de dados.

O que é a White Screen of Death

Na prática, a tela branca acontece quando o PHP encontra um erro fatal e interrompe a execução antes de devolver qualquer HTML ao navegador. Como muitas hospedagens mantêm a exibição de erros desligada (o correto, por segurança), em vez da mensagem de erro o visitante recebe uma página vazia. O conteúdo do site continua intacto no banco de dados — o que falhou foi o processamento, não os dados.

Como o problema costuma aparecer

• Página totalmente em branco, sem texto e sem mensagem de erro.
• Tela branca no site inteiro (front-end e painel) — geralmente tema, memória ou núcleo.
• Tela branca só no /wp-admin, com o site público funcionando — costuma ser plugin do painel.
• Tela branca só no front-end, mas o painel abre — aponta para o tema ou um plugin de front-end.
• Branco em uma única página ou post — quase sempre um shortcode, bloco ou trecho de código daquele conteúdo.
• Um e-mail do WordPress avisando que "o site teve um problema técnico" com um link de recuperação.

Onde está o branco → causa provável → ação

O lugar exato em que a tela branca aparece é o melhor atalho para a causa. Cruze o sintoma com a coluna de ação antes de mexer em qualquer arquivo:

As causas mais comuns

• Erro fatal de PHP: uma função inexistente, classe ausente ou incompatibilidade com a versão do PHP da hospedagem.
• Plugin com bug ou desatualizado: um plugin mal codificado ou incompatível com a versão atual do WordPress.
• Tema com defeito: tema (ou tema-filho) com erro, ou que parou de funcionar após uma atualização.
• Incompatibilidade após atualização: plugin, tema ou núcleo atualizado entrou em conflito com o restante do site. É a causa nº 1.
• Limite de memória PHP esgotado: o memory_limit da hospedagem é baixo demais para o que o site precisa carregar.
• Erro de sintaxe em código adicionado: um trecho colado no functions.php ou em um snippet com um ponto e vírgula a menos derruba o site inteiro.

O Modo de Recuperação do WordPress

Desde a versão 5.2, o WordPress traz uma proteção que ajuda muito nesses casos: o Modo de Recuperação de Erro Fatal. Quando o sistema detecta um erro fatal causado por um plugin ou tema, ele pausa automaticamente o item problemático e envia um e-mail ao endereço do administrador do site.

Esse e-mail contém um link especial de recuperação que abre o /wp-admin em um modo seguro, mesmo que o painel esteja com tela branca. Por ali você consegue desativar o plugin ou tema com defeito e voltar a ter acesso. Por isso é tão importante manter o e-mail de administrador atualizado e funcionando — é por ele que essa chave de emergência chega.

O que você pode verificar (sem riscos)

1. Onde está o branco? Teste o site público e o seusite.com.br/wp-admin separadamente. Anote onde aparece a tela branca e onde não.
2. Chegou e-mail de recuperação? Procure na caixa do administrador uma mensagem do WordPress com link de Modo de Recuperação e use-o.
3. Ative o WP_DEBUG: no wp-config.php, defina WP_DEBUG como true (e WP_DEBUG_LOG para gravar em arquivo) para enxergar o erro real em vez do branco.
4. Leia os logs: consulte o arquivo wp-content/debug.log e o log de erros do servidor no painel da hospedagem — eles costumam apontar o arquivo e a linha exata da falha.
5. Desative os plugins: sem acesso ao painel, renomeie a pasta wp-content/plugins via FTP ou gerenciador de arquivos. Se o site voltar, reative um a um para achar o culpado.
6. Troque para um tema padrão: renomeie a pasta do tema atual para forçar o WordPress a usar um tema padrão (Twenty Twenty-Something) e isolar problemas de tema.
7. Aumente a memória: tente elevar o memory_limit via wp-config.php (por exemplo, define('WP_MEMORY_LIMIT', '256M');) para descartar estouro de memória.

O bloco que destrava a maioria das telas brancas

Reúna depuração e memória num só lugar. Edite o wp-config.php e, logo acima da linha /* That's all, stop editing! */, acrescente:

// Mostra o erro real no log, sem exibi-lo ao visitante
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

// Descarta estouro de memoria como causa
define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');

Depois de salvar, recarregue a página branca e abra o wp-content/debug.log. Duas leituras possíveis: se a última linha citar "memory size… exhausted", era memória — o WP_MEMORY_LIMIT acima já deve resolver (aprofunde em memória esgotada). Se citar um "Fatal error" com nome de arquivo e linha, ali está o plugin, tema ou snippet culpado. O WP_MAX_MEMORY_LIMIT vale para tarefas pesadas do painel (importações, geração de imagens), enquanto o WP_MEMORY_LIMIT vale para o front-end. Lembre que o WP_MEMORY_LIMIT só eleva o limite se o servidor permitir: se mesmo assim nada mudar e o erro de memória persistir, o teto está travado no php.ini da hospedagem e precisa ser ajustado lá (ou junto ao suporte da hospedagem) — veja memória esgotada.

Como eu resolvo

Com os acessos em mãos, o trabalho é metódico e seguro:

• Ativo o WP_DEBUG e leio os logs de erro do servidor para encontrar o arquivo e a linha que dispararam o erro fatal.
• Faço backup completo de arquivos e banco antes de qualquer alteração de risco.
• Uso o Modo de Recuperação ou desativo plugins via FTP para isolar o conflito, e testo com o tema padrão.
• Ajusto o memory_limit quando o problema é de memória e reviso código adicionado ao functions.php ou a snippets.
• Corrijo a causa raiz — atualizo, reverto ou substituo o item incompatível por uma versão limpa — em vez de só "apagar o branco".
• Reativo tudo com calma, confirmo o site estável e oriento como evitar a reincidência.