Corrigindo a Tela Branca da Morte do WordPress

A "tela branca da morte" ocorre quando seu site WordPress exibe uma página em branco sem qualquer mensagem de erro. É um dos problemas mais frustrantes do WordPress porque não oferece nenhuma pista visível sobre a causa. Este guia explora as causas mais comuns e como corrigir cada uma.

Etapa 1: Verificar o Log de Erros

A primeira coisa a fazer é verificar seu log de erros PHP, que geralmente revela a causa exata:

1. Faça login em KPanel em kpanel.kapsulehost.com
2. Vá para Websites, selecione seu site e clique em Logs
3. Abra o PHP Error Log
4. Procure por entradas Fatal error próximas ao momento em que a tela branca apareceu

Consulte Accessing Your Website Error Logs para mais detalhes.

Etapa 2: Ativar o Modo de Depuração do WordPress

Se o log de erros não estiver mostrando detalhes suficientes, ative o modo de depuração do WordPress:

1. Conecte via SFTP ou pelo Gerenciador de Arquivos do KPanel
2. Abra wp-config.php
3. Defina o seguinte:

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

1. Recarregue a página e verifique wp-content/debug.log para a mensagem de erro

Etapa 3: Desativar Todos os Plugins

Um plugin com falha ou incompatível é a causa mais comum de uma tela branca após uma atualização.

Se você conseguir acessar o painel administrativo do WordPress: vá para Plugins > Installed Plugins, selecione todos e escolha Deactivate no menu de ações em massa.

Se você não conseguir acessar o painel administrativo do WordPress:

1. Conecte-se ao seu site via SFTP
2. Navegue até wp-content/plugins/
3. Renomeie a pasta plugins para plugins-disabled
4. Tente carregar o site

Se a tela branca desaparecer, um plugin é o culpado. Renomeie a pasta de volta para plugins, depois desative os plugins um de cada vez até identificar o plugin problemático.

Etapa 4: Alternar para um Tema Padrão

Um tema quebrado também pode causar uma tela branca:

1. Via SFTP, vá para wp-content/themes/
2. Renomeie a pasta do seu tema ativo para algo como mytheme-disabled
3. O WordPress voltará a um tema padrão

Etapa 5: Aumentar o Limite de Memória PHP

Uma tela branca pode ocorrer quando o WordPress fica sem memória. Para aumentar o limite:

1. Abra wp-config.php no Gerenciador de Arquivos ou via SFTP
2. Adicione esta linha antes da linha /* That's all, stop editing! */:

define( 'WP_MEMORY_LIMIT', '256M' );

1. Salve o arquivo e recarregue o site

Você também pode aumentar o limite de memória PHP em KPanel em Websites > [your site] > PHP Settings.

Etapa 6: Restaurar a Partir de um Backup

Se nenhuma das etapas acima resolver o problema, restaurar a partir de um backup feito antes do problema começar é o caminho mais rápido para a resolução. Consulte Restoring From Backup.

Ainda Não Resolvido?

Se a tela branca persistir após trabalhar com essas etapas, abra um ticket de suporte em KPanel em Support. Inclua as entradas mais recentes do log de erros PHP e uma descrição do que mudou no site antes do problema aparecer.