# Tela branca da morte no WordPress: 5 causas e como resolver 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.
Tela branca da morte: sintomas, causa raiz e ação corretiva
Sintoma Causa raiz provável Ação corretiva imediata
Site todo em brancoPlugin com erro fatal ou memória PHP esgotadaAtivar WP_DEBUG_LOG e ler o debug.log
Só o /wp-admin em brancoTema ativo com função quebradaTrocar o tema por um padrão via FTP
Branco após atualizar pluginConflito de plugin com PHP 8.2Renomear a pasta do plugin via FTP
Erro 500 intermitente.htaccess corrompidoRenomear .htaccess e regenerar permalinks
--- ## 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

Por que a tela branca da morte aparece sem nenhuma mensagem de erro?

Porque o WordPress por padrão oculta os erros PHP com WP_DEBUG_DISPLAY desligado em produção. O erro fatal encerra o script antes de enviar qualquer HTML, então o navegador recebe uma resposta vazia. Para ver a mensagem real, ative WP_DEBUG_LOG no wp-config.php: ele grava o erro completo em wp-content/debug.log sem expor nada ao visitante do site.

É possível resolver a tela branca da morte sem acesso ao painel do WordPress?

Sim, e é o cenário mais comum, já que o branco costuma travar o /wp-admin. Conecte por FTP ou pelo gerenciador de arquivos da hospedagem e renomeie a pasta wp-content/plugins para desativar todos os plugins de uma vez. Se o site voltar, o culpado é um plugin. Nenhuma dessas ações via FTP apaga conteúdo do banco de dados.

Qual a diferença entre tela branca total e tela branca só no admin?

A tela branca total atinge o site público e o painel ao mesmo tempo e aponta para causa global: plugin com erro fatal ou memória PHP esgotada. A tela branca só no /wp-admin, com o front-end funcionando ou vice-versa, isola o problema no tema ativo. Essa diferença de escopo corta o tempo de diagnóstico pela metade antes de tocar em qualquer arquivo.

Quanto tempo leva para identificar a causa da tela branca da morte?

Com WP_DEBUG_LOG ativo, costuma levar menos de 5 minutos: você ativa o log, recarrega a página e lê a última linha do debug.log, que nomeia o arquivo e a linha do erro. Sem o log, o método de tentativa por FTP leva de 15 a 30 minutos. Ativar o log primeiro é sempre o caminho mais rápido e seguro.

O que é WP_DEBUG e como ele ajuda na tela branca da morte?

WP_DEBUG é uma constante PHP do wp-config.php que liga o modo de depuração do WordPress. Sozinha, ela exibe os erros na tela, o que não convém em produção. Combinada com WP_DEBUG_LOG igual a true e WP_DEBUG_DISPLAY igual a false, ela registra todo erro em wp-content/debug.log de forma silenciosa. É a forma oficial e segura de descobrir a causa exata do branco.

--- ## 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.