~ O Blog de 1999 ~

O teu site está em branco. E agora?

Abres o teu site WordPress e, em vez da página inicial, vês uma página branca. Sem erro, sem mensagem, nada. É o famoso White Screen of Death, e assusta na primeira vez. Quase sempre tem solução, e normalmente em poucos minutos.

As causas mais comuns e a ordem exata para as verificar. Vai de cima para baixo e encontras o culpado antes de chegares ao fim.

1. Confirma se é mesmo o site todo

Abre o site numa janela privada e tenta também a área de administração em /wp-admin. Se o admin carrega mas o front end está em branco, o problema costuma estar no teu tema. Se ambos estão em branco, é mais provável um plugin ou um erro de PHP. Esta única verificação reduz muito a procura.

2. Liga o relatório de erros

Na maioria das vezes, a página em branco é um erro fatal de PHP que está escondido. Liga a exibição de erros para o WordPress te dizer o que está errado. Adiciona isto ao wp-config.php, logo a seguir às definições da base de dados:

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

Recarrega a página. Se aparecer uma mensagem, tens a tua resposta. Se não aparecer nada, verifica o wp-content/debug.log para veres o erro. Lembra-te de desligar isto num site em produção quando terminares.

3. O limite de memória, o suspeito habitual

Mencionaste a memória, e tens razão em suspeitar dela. Um plugin ou tema que pede mais memória do que o PHP permite lança um erro fatal e a página fica em branco. Aumenta o limite no wp-config.php:

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

Se isto resolver, o problema real é um plugin ou tema a usar demasiada memória, e deves descobrir qual em vez de aumentar o limite para sempre.

4. Desativa os plugins um a um

Renomeia a pasta wp-content/plugins para wp-content/plugins-off usando o gestor de ficheiros ou FTP. Isto desativa todos os plugins de uma vez. Se o site voltar, um plugin é a causa. Renomeia de volta e depois desativa os plugins um a um, renomeando as pastas individuais, até o site voltar a partir. Essa pasta é o teu culpado.

5. Muda para um tema predefinido

Se os plugins não forem o problema, experimenta o tema. Renomeia a pasta do teu tema ativo em wp-content/themes/. O WordPress volta para um tema predefinido. Se o site carregar, o teu tema é o problema, normalmente um erro de PHP ou um problema de compatibilidade com uma atualização recente.

6. Verifica se houve uma quebra de compatibilidade

Se a página em branco começou logo após uma atualização, a causa costuma ser um plugin ou tema que não é compatível com a nova versão do WordPress ou do PHP. Verifica as páginas dos plugins e temas para atualizações, e olha para a versão de PHP que o teu alojamento está a usar. Às vezes um plugin precisa de uma versão mais recente de PHP, ou um antigo parte no PHP 8.

7. Ainda em branco? Verifica o básico

Se nada disto funcionar, verifica algumas coisas aborrecidas que também causam páginas em branco: disco cheio no servidor, um ficheiro .htaccess corrompido, ou permissões de ficheiros partidas. Pede ao teu alojamento para verificar o log de erros do servidor, que muitas vezes tem a linha exata que está a falhar.

A versão curta

O White Screen of Death é um erro de PHP escondido atrás de uma página em branco. Liga o relatório de erros, verifica o limite de memória, e depois desativa plugins e muda de tema para isolar a causa. Nove em cada dez vezes é um plugin ou uma atualização de tema, e resolves em minutos sem tocar no teu conteúdo.