Tela Branca da Morte do WordPress

O que este erro significa e como reconhecê-lo

• O front end do WordPress, o painel de administração ou ambos exibem uma página branca completamente vazia, sem mensagem de erro.
• A falha pode afetar o site inteiro ou apenas uma tela específica do painel, template, shortcode, bloco ou URL.
• A página em branco pode aparecer imediatamente após a instalação ou atualização de um plugin ou tema.
• O problema pode começar depois que o provedor de hospedagem altera a versão do PHP do site.
• As requisições afetadas continuam retornando uma página em branco até que o plugin, tema, problema de memória, incompatibilidade ou arquivo danificado que causa a falha do PHP seja corrigido.

Causas principais, por probabilidade

1. Erro fatal do PHP em um plugin — a causa mais provável quando o problema começa após a instalação ou atualização de um plugin, ou quando apenas páginas relacionadas a plugins falham.
2. Erro no tema ativo — um problema no tema ou em seu functions.php pode afetar muitas páginas ou o site inteiro.
3. Memória do PHP esgotada — uma requisição pode exceder o memory_limit configurado; o log geralmente informa Allowed memory size exhausted.
4. Incompatibilidade com a versão do PHP — um plugin ou tema pode conter código que não funciona com a versão do PHP usada atualmente pelo host.
5. Arquivos do core do WordPress corrompidos — uma atualização interrompida ou incompleta pode danificar arquivos do core, embora isso seja menos provável quando a falha ocorre claramente após uma alteração em um plugin ou tema.

Como corrigir

1. Proteja o site e identifique a requisição que falhou

Se as ferramentas da sua hospedagem oferecerem backups, faça um antes de editar os arquivos. Anote se a página em branco afeta o front end, o painel ou apenas uma URL específica. Você precisará de acesso ao SFTP ou ao gerenciador de arquivos do painel de hospedagem, além de permissão para editar wp-config.php.

2. Ative o log de depuração sem expor erros aos visitantes

Abra wp-config.php e adicione ou atualize estas configurações, garantindo que cada constante apareça apenas uma vez:

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

Mantenha WP_DEBUG_DISPLAY definido como false em um site em produção. Recarregue a URL exata que exibe a tela branca e verifique wp-content/debug.log. Procure o erro fatal, o caminho do arquivo e o número da linha. Se o log do WordPress não for criado ou não contiver o evento, peça ao host para verificar o log de erros do PHP da conta.

3. Desative o plugin identificado pelo log

Se o erro mencionar um plugin, use o SFTP ou o gerenciador de arquivos da hospedagem para abrir wp-content/plugins/. Renomeie a pasta do plugin relevante adicionando um sufixo como -disabled. Renomear a pasta impede que o WordPress carregue o plugin, preservando seus arquivos e configurações.

Recarregue a URL que falhou. Se ela funcionar, o plugin é a causa imediata. Verifique se existe uma atualização compatível ou entre em contato com o desenvolvedor do plugin se não houver uma atualização adequada para as versões do WordPress e do PHP do site. Não deixe um plugin incompatível ou desatualizado ativo apenas porque renomear sua pasta restaurou o site.

4. Teste o tema ativo

Se o log apontar para o tema ativo ou se desativar o plugin identificado não ajudar, renomeie a pasta desse tema em wp-content/themes/. O WordPress deverá usar um tema padrão disponível como alternativa.

Se o site se recuperar, verifique o arquivo e a linha indicados no log, prestando atenção especial a functions.php. Se nenhum tema alternativo utilizável estiver instalado, restaure o nome original da pasta após o teste e entre em contato com o provedor do tema ou com o host antes de fazer outras alterações.

5. Resolva um erro de esgotamento de memória

Se o log informar Allowed memory size exhausted, a requisição que falhou excedeu o limite de memória do PHP configurado. Siga o procedimento da hospedagem ou da administração do WordPress para aumentar o limite com segurança e investigue se um plugin, tema ou requisição específica está consumindo memória em excesso.

Após fazer uma alteração de configuração autorizada, recarregue a mesma URL e confirme que o erro fatal idêntico não está mais sendo registrado. Aumentar o limite pode apenas mascarar um componente ineficiente ou incompatível; portanto, continue investigando se o erro retornar.

6. Verifique a compatibilidade com a versão do PHP

Se a tela branca começou após uma alteração na versão do PHP, compare o momento da alteração com o plugin ou tema mencionado no log. Desativar temporariamente essa extensão pode ajudar a confirmar a relação.

Pergunte ao host se é possível fazer um rollback temporário da versão do PHP enquanto o plugin ou tema é atualizado, substituído ou corrigido. Trate o rollback como uma medida de diagnóstico ou temporária, não como uma correção permanente de compatibilidade.

7. Restaure os arquivos do core somente quando houver evidências

Se nenhuma alteração em plugin, tema, PHP ou memória explicar a falha e o log não identificar uma extensão, é possível que os arquivos do core do WordPress estejam danificados. Reenvie arquivos correspondentes do core do WordPress a partir de um download oficial novo do WordPress usando SFTP.

Não sobrescreva wp-content nem wp-config.php. Se você não conseguir distinguir com segurança os arquivos do core do conteúdo e da configuração do site, pare e peça ajuda ao host ou a um profissional de WordPress.

8. Verifique a recuperação e faça a limpeza

Recarregue a URL exata do front end ou a tela de administração que estava em branco. Teste páginas relacionadas que usem o mesmo plugin, tema, shortcode ou bloco. Revise wp-content/debug.log e confirme que o mesmo erro fatal não está ocorrendo novamente.

Depois de confirmar a causa, desative as alterações temporárias de depuração ou garanta que qualquer log mantido esteja protegido contra acesso público.

Prevenção e como verificar a correção

• Faça backup do site antes de atualizar o WordPress, plugins, temas ou a versão do PHP da hospedagem.
• Atualize plugins e temas um por vez para que seja possível identificar a alteração associada a uma falha.
• Teste alterações importantes no WordPress, PHP, temas e plugins em uma cópia de staging antes de aplicá-las em produção.
• Mantenha WP_DEBUG_DISPLAY desativado em sites em produção e restrinja o acesso a qualquer log de depuração.
• Monitore a memória PHP disponível e investigue componentes que se aproximam repetidamente do limite configurado.
• Após cada correção, recarregue a URL exata que falhou e verifique o log para confirmar que o mesmo erro fatal não voltou a ocorrer.

Perguntas frequentes