Resolver o Ecrã Branco da Morte do WordPress

O "ecrã branco da morte" ocorre quando o seu site WordPress apresenta uma página em branco, sem qualquer mensagem de erro. É um dos problemas mais frustrantes do WordPress, pois não dá qualquer indicação visível sobre a causa. Este guia percorre as causas mais comuns e como resolver cada uma delas.

Passo 1: Verificar o Registo de Erros

A primeira coisa a fazer é verificar o seu registo de erros PHP, que normalmente revela a causa exata:

1. Inicie sessão no KPanel em kpanel.kapsulehost.com
2. Vá a Websites, selecione o seu site e clique em Registos
3. Abra o Registo de Erros PHP
4. Procure entradas Fatal error próximas do momento em que o ecrã branco começou

Consulte Aceder aos Registos de Erros do Seu Website para mais detalhes.

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

Se o registo de erros não estiver a mostrar informação suficiente, ative o modo de depuração do WordPress:

1. Ligue-se via SFTP ou através do Gestor de Ficheiros 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 ver a mensagem de erro

Passo 3: Desativar Todos os Plugins

Um plugin com falhas ou incompatível é a causa mais comum de um ecrã branco após uma atualização.

Se conseguir aceder à administração do WordPress: vá a Plugins > Plugins Instalados, selecione todos e escolha Desativar no menu de ações em massa.

Se não conseguir aceder à administração do WordPress:

1. Ligue-se ao seu site via SFTP
2. Navegue até wp-content/plugins/
3. Mude o nome da pasta plugins para plugins-disabled
4. Tente carregar o site

Se o ecrã branco desaparecer, um plugin é o culpado. Mude o nome da pasta de volta para plugins e, em seguida, desative os plugins um a um até identificar o plugin responsável.

Passo 4: Mudar para um Tema Predefinido

Um tema danificado também pode causar um ecrã branco:

1. Via SFTP, vá a wp-content/themes/
2. Mude o nome da pasta do seu tema ativo para algo como mytheme-disabled
3. O WordPress irá recorrer a um tema predefinido

Passo 5: Aumentar o Limite de Memória PHP

Pode ocorrer um ecrã branco quando o WordPress fica sem memória. Para aumentar o limite:

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

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

1. Guarde o ficheiro e recarregue o site

Também pode aumentar o limite de memória PHP no KPanel, em Websites > [o seu site] > Definições > PHP.

Passo 6: Restaurar a Partir de uma Cópia de Segurança

Se nenhum dos passos anteriores resolver o problema, restaurar a partir de uma cópia de segurança feita antes de o problema começar é a forma mais rápida de resolução. Consulte Restaurar a Partir de uma Cópia de Segurança.

Ainda Não Resolvido?

Se o ecrã branco persistir depois de seguir estes passos, abra um pedido de suporte no KPanel em Suporte. Inclua as entradas mais recentes do registo de erros PHP e uma descrição do que foi alterado no site antes de o problema surgir.