Para resolver o erro tela branca da morte no WordPress, ative o modo de depuração no wp-config.php, leia o arquivo debug.log e identifique o plugin, o tema ou o limite de memória responsável. Na maioria dos casos, renomear a pasta do plugin suspeito via FTP ou pelo gerenciador de arquivos devolve o site ao ar em poucos minutos.
Você digita o endereço do seu blog e a página aparece completamente em branco, sem menu, sem texto, sem mensagem de erro. Esse é o erro tela branca da morte no WordPress (em inglês, White Screen of Death), e ele assusta porque parece que o site inteiro desapareceu.
Na prática, os seus posts, páginas e configurações continuam salvos no banco de dados. O que travou foi o código PHP que monta a página, quase sempre por causa de um plugin, de um tema, de falta de memória ou de um arquivo corrompido.
A sequência abaixo começa pelo que não exige mexer em código e avança para as correções mais técnicas, sempre dizendo o que observar e o que alterar. Com uma tela branca no WordPress, a ordem dos testes importa mais do que a velocidade.
O que causa a tela branca da morte no WordPress
A tela branca da morte é uma página vazia que aparece quando o PHP encontra um erro fatal e o WordPress não consegue exibir nenhuma mensagem. Ela pode afetar o site inteiro, só o painel administrativo ou apenas algumas páginas.
Desde a versão 5.2, o WordPress tem um sistema de proteção contra erros fatais que costuma mostrar um aviso de problema crítico e enviar ao administrador um e-mail com link de modo de recuperação. Mesmo assim, a página totalmente branca ainda pode aparecer, principalmente quando o erro acontece cedo demais no carregamento ou quando a hospedagem esconde as mensagens de erro.
As causas mais frequentes são estas:
- Plugin com bug ou incompatível com a versão do WordPress ou do PHP.
- Tema com erro no arquivo functions.php, muitas vezes depois de colar um trecho de código.
- Limite de memória do PHP esgotado.
- Versão do PHP incompatível com algum componente do site.
- Atualização interrompida, que deixa arquivos pela metade.
- Arquivo do núcleo do WordPress corrompido ou alterado.
Cada causa deixa uma pista diferente no log de erros, por isso o diagnóstico vem antes de qualquer correção. Quem está montando o primeiro blog e quer aprender essa base de WordPress com método pode conhecer a Formação Império dos Blogs, que reúne cursos como Monetizando Blogs com o Google AdSense e Blogs Lucrativos.
O que fazer antes de mexer em qualquer arquivo
Antes de editar qualquer coisa, três verificações rápidas podem resolver o problema ou apontar a causa.
Primeiro, acesse o endereço /wp-admin do seu site. Se o painel abre normalmente e só o site público está em branco, a suspeita recai com mais frequência sobre o tema ou sobre um plugin que atua apenas na parte visível. Se os dois estão em branco, o problema costuma estar em um plugin, no núcleo ou na memória do PHP. Essa observação reduz o número de testes que você vai precisar fazer.
Segundo, procure no e-mail do administrador uma mensagem sobre problema técnico no site (olhe também o spam). Quando ela existe, traz o nome do plugin ou do tema que causou o erro e um link temporário para entrar no painel em modo de recuperação.
Terceiro, limpe o cache do navegador, do plugin de cache e do CDN, como o Cloudflare. Pode parecer óbvio, mas já vi gente passar horas mexendo em arquivos por causa de uma versão em branco guardada em cache.
Minha dica aqui é fazer um backup pelo painel da hospedagem antes de qualquer alteração. Se algo piorar, você volta ao ponto de partida em minutos.
Como ativar o modo de depuração e ler o erro real
O modo de depuração do WordPress grava o erro fatal em um arquivo de log e mostra exatamente qual arquivo e qual linha causaram a tela branca. Acesse os arquivos do site por FTP ou pelo gerenciador de arquivos da hospedagem, abra o wp-config.php e adicione estas linhas acima do comentário que manda parar de editar:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );Recarregue o site e abra o arquivo wp-content/debug.log. Com WP_DEBUG_DISPLAY em false, os erros não aparecem para os visitantes, mas continuam registrados. A documentação oficial do WordPress sobre depuração descreve o que cada uma dessas constantes faz.
Procure a linha que começa com PHP Fatal error. Um exemplo típico é “Allowed memory size exhausted in /wp-content/plugins/nome-do-plugin/arquivo.php on line 123”. O caminho indica o culpado: se aparece /plugins/, o problema é um plugin; se aparece /themes/, é o tema. Se o navegador mostrar um erro 500 em vez de página vazia, o diagnóstico muda um pouco, e o guia sobre erro 500 no WordPress e como corrigir cobre esse cenário.
Um erro clássico é desativar todos os plugins sem ler o log. O log costuma apontar o responsável em segundos, e desativar tudo às cegas só adia a descoberta da causa real. Quando terminar, volte o WP_DEBUG para false: em alguns servidores o debug.log pode ficar acessível pelo navegador, e deixá-lo ligado em produção expõe informações do site.
Como resolver quando a causa é um plugin ou o tema
Quando o log aponta um plugin ou um tema, a solução é desativá-lo renomeando a pasta correspondente por FTP, sem precisar entrar no painel. Esse é o método de desativar plugins por FTP, e funciona mesmo com o painel fora do ar.
Para um plugin, vá até wp-content/plugins, localize a pasta citada no log e troque o nome (por exemplo, de nome-do-plugin para nome-do-plugin-off). O WordPress deixa de encontrar o plugin e o desativa automaticamente. Recarregue o site: se ele voltou, entre no painel e decida entre atualizar, trocar ou remover o plugin.
Se o log não indicar um plugin específico, renomeie a pasta plugins inteira para plugins-off. Com o site de volta, devolva o nome original e reative um plugin por vez, testando o site a cada ativação, até a tela branca reaparecer. O último plugin ativado é o culpado.
Para o tema, vá a wp-content/themes e renomeie a pasta do tema ativo. O WordPress tenta usar um tema padrão instalado, por isso vale manter pelo menos um tema oficial na pasta. Se o erro está no functions.php, você também pode abrir o arquivo por FTP e remover o trecho de código que acabou de adicionar.
O editor de temas do painel é uma armadilha: um ponto e vírgula esquecido no functions.php pode derrubar o site e o painel ao mesmo tempo. Edite código sempre por FTP ou use um plugin de snippets, que desativa o trecho com erro sozinho.
Plugins e temas baixados de fontes não oficiais, as versões “nulled”, são uma origem frequente de código malicioso e de erros fatais. Se o arquivo citado no log tem nome estranho, foi alterado sem você mexer ou contém código embaralhado, trate como possível invasão e siga o passo a passo para remover malware de um site WordPress.
Como corrigir o erro por falta de memória do PHP
Quando o log mostra a mensagem Allowed memory size exhausted, o PHP atingiu o limite de memória liberado pela hospedagem, e a correção é aumentar esse limite ou reduzir o consumo. No wp-config.php, acima do comentário que manda parar de editar, adicione:
define( 'WP_MEMORY_LIMIT', '256M' );Valores como 128M, 256M e 512M são faixas comuns de referência e variam conforme o plano da hospedagem, então não existe um número ideal para todos os sites. Se a alteração não surtir efeito, a hospedagem pode impor um teto próprio. Nesse caso, ajuste o memory_limit nas opções de PHP do painel ou peça ao suporte, e consulte a documentação do PHP sobre a diretiva memory_limit para entender como o valor é interpretado.
Se o erro volta mesmo com 256M, aumentar a memória apenas esconde o sintoma. O problema real costuma ser um plugin com consumo anormal ou um plano de hospedagem pequeno demais para o tamanho do site.
Quem depende de anúncios sente cada hora fora do ar no bolso, já que sem página carregada não há impressão nem clique. Para transformar o blog em uma fonte de renda estável, o curso Monetizando Blogs com o Google AdSense, incluído no pacote de cursos do Império dos Blogs, ensina a estruturar e monetizar o site com método.
Versão do PHP, atualização interrompida e arquivos do núcleo
Se plugin, tema e memória foram descartados, as causas restantes são versão do PHP incompatível, atualização interrompida ou arquivos do núcleo corrompidos.
Para testar o PHP, troque a versão no painel da hospedagem por uma anterior e recarregue o site. Se ele voltar, algum componente ainda não é compatível com a versão nova. Atualize ou substitua esse componente em vez de manter a versão antiga por tempo indefinido, porque versões antigas do PHP deixam de receber correções de segurança.
Se o site travou durante uma atualização, procure na raiz um arquivo chamado .maintenance e apague-o. Ele costuma gerar a mensagem de manutenção em vez de tela branca, mas uma atualização que falha também pode deixar plugins pela metade. Nesse caso, reinstale o plugin afetado por FTP, usando uma cópia nova baixada do repositório oficial.
Para recuperar o núcleo, baixe a versão atual do WordPress em wordpress.org, extraia o arquivo e envie por FTP as pastas wp-admin e wp-includes, substituindo as existentes. Não substitua a pasta wp-content nem o wp-config.php, porque eles guardam seus temas, plugins, uploads e configurações.
Tabela de diagnóstico: o que fazer conforme o sintoma
A tabela abaixo reúne regras de decisão do tipo “se acontecer X, faça Y”: com o sintoma e a linha do log em mãos, você sabe qual correção tentar primeiro e evita o erro comum de testar tudo ao mesmo tempo.
| O que você observa | Causa provável | O que fazer |
|---|---|---|
| Painel abre, site público em branco | Tema ou plugin da parte visível | Renomear a pasta do tema ativo |
| Tudo em branco, log cita /plugins/ | Plugin com erro fatal | Renomear a pasta do plugin citado |
| Log cita Allowed memory size exhausted | Limite de memória do PHP | Aumentar o WP_MEMORY_LIMIT e revisar o consumo |
| Log cita /themes/ e functions.php | Erro de sintaxe no tema | Corrigir ou remover o trecho por FTP |
| Erro após trocar a versão do PHP | Incompatibilidade | Voltar a versão e atualizar o componente |
| Arquivos desconhecidos ou código embaralhado | Possível invasão | Restaurar backup limpo e verificar malware |
| Nada no debug.log | Erro antes do carregamento ou log em outro local | Conferir o log de erros do servidor na hospedagem |
Como evitar que a tela branca volte
Evitar a tela branca depende de três hábitos: testar antes de atualizar, manter backup recente e limitar a quantidade de plugins instalados.
Depois de publicar mais de 500 artigos no kildaryoliver.com.br, o que eu faço é nunca atualizar plugin direto no site principal sem um backup recente. Em um blog desse tamanho, uma atualização ruim custa horas de trabalho, e o backup transforma um problema grande em uma restauração simples.
Sempre que possível, teste atualizações grandes em uma cópia do site (ambiente de testes), que muitas hospedagens oferecem no painel. Remova plugins que você não usa mais, porque cada plugin extra é mais uma chance de conflito, e prefira plugins com atualizações recentes e boa compatibilidade com a sua versão do PHP.
Se o seu site está no WordPress.com, o acesso por FTP e a instalação de plugins dependem do plano contratado, o que muda a forma de resolver problemas. Entender a diferença entre WordPress.com e WordPress.org ajuda a saber quais correções deste texto se aplicam ao seu caso.
Conclusão
A tela branca da morte no WordPress assusta, mas quase sempre tem uma causa localizável. O modo de depuração mostra o arquivo e a linha responsáveis, e a partir daí a correção costuma ser renomear uma pasta, aumentar um limite ou restaurar um arquivo. O que mais atrapalha é a pressa de mudar várias coisas ao mesmo tempo.
Se você seguir a ordem do texto (backup, teste do painel, leitura do log, plugin e tema, memória, PHP e núcleo), cada tentativa elimina uma hipótese e deixa o diagnóstico mais claro. Guarde a tabela de decisão como referência, porque o mesmo sintoma tende a reaparecer em outros sites que você venha a administrar.
Com o site de volta, desligue o WP_DEBUG, atualize o que estava desatualizado e agende backups automáticos. O tempo investido nisso evita uma tarde inteira com o site fora do ar na próxima vez.
Sou Kildary Oliver, especialista em WordPress, SEO e monetização com Google AdSense, e trabalho com blogs desde 2018. Mais de 300 blogs de alunos foram aprovados no AdSense, tenho mais de 28 mil inscritos no YouTube e mais de 10 mil alunos em cursos. Atualizo meus artigos quando o Google muda as regras. Conheça meu trabalho na página Sobre o Autor.
