A tela branca da morte no WordPress é uma página totalmente em branco causada por um erro fatal de PHP que apaga a saída. Segundo a WordPress Developer Docs (2024), o WP_DEBUG_LOG grava todo erro PHP em wp-content/debug.log sem expor nada ao visitante. As 5 causas cobrem a maioria dos casos. Comece sempre pelo log antes de mexer.

A tela branca da morte no WordPress é o nome popular do erro em que o site carrega uma página inteiramente em branco, sem texto, sem layout e sem mensagem. Ela acontece quando o PHP encontra um erro fatal e encerra a execução antes de enviar qualquer HTML ao navegador. Na maioria dos casos a origem é um plugin, um tema ou o limite de memória PHP estourado. Boa parte dos tickets que chegam ao suporte da FULL com esse sintoma resolve com três verificações na ordem certa. Este guia mostra as 5 causas reais e o passo a passo para sair da tela branca da morte sem perder o site. Veja também os 50 erros mais comuns do WordPress para o quadro completo.

Diagnóstico rápido: Sintoma, causa raiz e ação

A tela branca da morte tem 5 causas que respondem por boa parte dos atendimentos: plugin com erro fatal, tema quebrado, limite de memória PHP baixo, arquivo .htaccess corrompido e versão de PHP incompatível. O atalho de diagnóstico é simples: se a tela aparece no site todo, a causa costuma ser global; se aparece só no /wp-admin, isole o tema.

A tabela abaixo cruza cada sintoma com a causa provável e a primeira ação corretiva. Use o hub de erros do WordPress da FULL para os guias relacionados de cada erro citado.

Plugin com erro fatal: A causa número 1

Plugins respondem pela maior parte dos casos de tela branca da morte que chegam ao suporte da FULL, e o gatilho quase sempre é uma função PHP removida da linguagem. Um plugin desatualizado que chama uma função deprecada, somado a um servidor rodando PHP 8.2, gera um fatal error que zera a saída e exibe a página totalmente em branco ao visitante.

A correção é desativar os plugins sem o painel: acesse o site por FTP ou pelo gerenciador de arquivos da hospedagem, vá até wp-content/plugins e renomeie a pasta plugins para plugins-off. O WordPress desativa tudo de uma vez. Se o site volta, renomeie de volta e reative um plugin por vez até o branco retornar: o último ativado é o culpado. Para entender o mecanismo, vale ler como cada plugin do WordPress interage com a versão do PHP do servidor.

Tema quebrado: Quando só o admin some

Quando a tela branca da morte aparece apenas no site público e o /wp-admin continua acessível, a causa provável é o tema ativo, e não um plugin. Isso ocorre porque o tema controla a renderização do front-end: uma função quebrada no functions.php ou uma chamada a um arquivo ausente derruba só a parte pública do site.

A ação é forçar um tema padrão. Conecte por FTP, entre em wp-content/themes e renomeie a pasta do tema ativo. O WordPress não encontra o tema, recorre automaticamente a um tema padrão como o Twenty Twenty-Four e o site volta a carregar. Se voltar, o problema estava no tema anterior: atualize-o ou troque por um tema mantido. Em média essa troca leva menos de 5 minutos e não apaga nenhum conteúdo, já que o tema só controla a aparência, não os dados.

Limite de memória PHP: O branco silencioso

O limite de memória PHP estourado é a causa mais traiçoeira da tela branca da morte, porque some sem deixar mensagem visível. O WordPress aloca por padrão apenas 40 MB de memória; temas pesados, builders e páginas com muitos elementos ultrapassam esse teto e o PHP encerra o processo no meio do render daquela página.

O sintoma clássico é a tela branca aparecer só em uma página específica, não no site inteiro. A correção é aumentar o limite no arquivo wp-config.php: adicione a linha define(‘WP_MEMORY_LIMIT’, ‘256M’); logo antes do comentário “That’s all, stop editing”. Subir para 256 MB resolve a grande maioria desses casos antes de você desativar qualquer plugin. Se quiser confirmar o gargalo, a ferramenta Query Monitor mostra o pico de memória por requisição. Para fundo, veja como reduzir o uso de CPU e memória do seu site.

.Htaccess e PHP incompatível: As causas de servidor

As 2 últimas causas da tela branca da morte moram no servidor, não no WordPress: um arquivo .htaccess corrompido e uma versão de PHP incompatível. Um .htaccess danificado após mudança de permalinks, em servidores Apache, gera um erro 500 que o navegador às vezes exibe como uma página em branco.

A correção do primeiro caso é renomear o .htaccess para .htaccess-old via FTP e, depois de entrar no painel, salvar os permalinks em Configurações para gerar um novo arquivo limpo. Já a versão de PHP entra quando o site roda em PHP antigo ou novo demais para o tema: o WordPress 6.x recomenda PHP 8.1 ou superior. Troque a versão no painel da hospedagem em 1 clique e teste. Se nada disso resolver, restaure pelo backup mais recente e investigue em ambiente de teste.

Ative o wp_debug_log antes de adivinhar

Ativar o WP_DEBUG_LOG é o passo que transforma a tela branca da morte de mistério em diagnóstico de 1 minuto, porque ele grava a mensagem real do erro em um arquivo de texto. Em vez de tentar causa por causa às cegas, você lê exatamente qual arquivo e qual linha do código falharam naquela requisição.

No wp-config.php, troque a linha do WP_DEBUG por três linhas: define(‘WP_DEBUG’, true); define(‘WP_DEBUG_LOG’, true); e define(‘WP_DEBUG_DISPLAY’, false);. Segundo a documentação oficial do WordPress, essa combinação grava todos os erros PHP em wp-content/debug.log sem mostrar nada ao visitante: seguro para usar em produção por alguns minutos. Recarregue a página em branco, abra o debug.log e a última linha aponta o plugin, o tema ou a função responsável. Veja o passo a passo oficial na página de debug das WordPress Developer Docs, mantida pela própria equipe do core. Esse log também é o primeiro lugar onde a gente olha no suporte da FULL.

Tenha quem resolva a tela branca por você

Resolver a tela branca da morte sozinho é viável, mas em produção cada minuto fora do ar pesa, e ter um plugin de gestão que isola o erro encurta muito o diagnóstico de cada incidente. O plano PRO da FULL custa R$849,90 por ano e conecta até 10 sites, o que dá cerca de R$85 por site.

São 17 plugins do bundle ativados em 1 clique, incluindo o All in One Security e o UpdraftPlus para backup automático antes de qualquer edição arriscada no wp-config.php. A gente vê no suporte da FULL que a maioria das telas brancas em sites geridos é evitada só por manter plugins e PHP atualizados. Conheça os planos da FULL e ative tudo sem tocar em FTP.

Perguntas frequentes sobre a tela branca da morte

Próximos passos para sair da tela branca

Sair da tela branca da morte é uma questão de ordem: ativar o WP_DEBUG_LOG, ler o debug.log e atacar a causa que o log apontar, em vez de adivinhar plugin por plugin. Na prática, plugin, tema e memória PHP cobrem a maioria absoluta dos casos, e .htaccess mais versão de PHP fecham o resto. Antes de qualquer edição no wp-config.php, faça um backup , é o que separa um susto de 5 minutos de uma reconstrução. Para continuar aprendendo, o FULL Academy reúne tutoriais, guias e reviews de WordPress em um só lugar, e o guia de como corrigir erros comuns do WordPress aprofunda cada um desses sintomas. Se preferir não mexer em FTP, manter os plugins e o PHP atualizados num painel de gestão evita boa parte dessas telas brancas antes que elas aconteçam.

Legenda: a página totalmente em branco que o erro fatal de PHP gera quando encerra o script antes de enviar o HTML.