Tela branca da morte no WordPress: como resolver

A tela branca da morte no WordPress é quase sempre um erro fatal de PHP — conflito de plugin, tema quebrado ou memória esgotada. Como não há mensagem, ative o WP_DEBUG para ver a causa e desative os plugins via FTP para isolar o culpado.

Nenhum aviso, nenhum código de erro. Só uma página branca onde antes havia um site. A “tela branca da morte” (WSOD, White Screen of Death) é o erro mais desnorteante do WordPress justamente porque esconde a causa. Este guia mostra como forçá-la a falar e corrigir em minutos. É parte do guia maior de erros comuns do WordPress.

O que é a tela branca da morte

A tela branca da morte é uma página totalmente em branco exibida quando o PHP encontra um erro fatal e para a execução sem renderizar nada. Pode afetar o site inteiro, só o wp-admin, ou apenas uma página específica — e cada caso aponta para uma causa diferente.

O ponto-chave: o branco não é o problema, é o sintoma. Por padrão, o WordPress esconde o erro do PHP do visitante. Seu trabalho é reativar essa mensagem para ver o que realmente quebrou.

Passo 1 — Faça o erro aparecer (WP_DEBUG)

Antes de tentar qualquer correção às cegas, force o WordPress a mostrar o erro. No wp-config.php, antes de /* That's all, stop editing! */:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );      // grava em wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // não expõe o erro ao público

Recarregue o site e abra wp-content/debug.log. A última linha mostra o arquivo e a linha exata do erro fatal — normalmente apontando para um plugin ou tema específico. Com isso, você já sabe onde mirar.

Faça backup antes de editar qualquer arquivo.

Passo 2 — Descubra o escopo do branco

Onde está branco muda o diagnóstico:

• Site inteiro (front + admin) → erro fatal global: plugin, memória ou core. Continue abaixo.
• Só o wp-admin → plugin de administração ou memória insuficiente. Pule pro Passo 5 (memória) e desative plugins.
• Só uma página/post → tema (arquivo de template) ou um shortcode/bloco daquela página.

Passo 3 — Use o modo de recuperação (WordPress 5.2+)

Desde a versão 5.2, o WordPress detecta o erro fatal e envia um e-mail para o administrador com um link de “modo de recuperação”. Esse link abre o painel mesmo com o site quebrado e já indica qual plugin ou tema causou a pausa.

Cheque a caixa do e-mail de admin (e o spam). Se o e-mail chegou, é o caminho mais rápido: entre, desative o culpado apontado e pronto.

Passo 4 — Isole o plugin culpado (via FTP)

Sem e-mail de recuperação ou sem acesso ao painel, vá pelo FTP/SFTP ou pelo gerenciador de arquivos do host:

1. Navegue até wp-content/.
2. Renomeie a pasta plugins para plugins_old.
3. Recarregue o site.

Se o site voltar, o problema é um plugin. Agora:

4. Renomeie a pasta de volta para plugins.
5. Dentro dela, renomeie cada plugin um a um (ou reative pelo painel um a um), recarregando o site a cada teste, até o branco voltar. O último que você mexeu é o culpado.

Com WP-CLI, isso é mais rápido:

wp plugin deactivate --all
# reative um a um:
wp plugin activate nome-do-plugin

Passo 5 — Aumente o limite de memória PHP

Se o debug.log mostrou “Allowed memory size … exhausted”, o site bateu no teto de memória do PHP. No wp-config.php:

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

Recarregue. Se resolver, ótimo — mas investigue o que consumia tanta memória (plugin pesado, importação, loop). Se não mudar nada, o limite real está no servidor (php.ini) e é com o host que você resolve.

Passo 6 — Descarte o tema

Se os plugins não eram o problema, teste o tema. Pelo FTP, renomeie a pasta do tema ativo em wp-content/themes/ — o WordPress cai automaticamente para um tema padrão (Twenty Twenty-*). Site voltou? O problema estava no tema: um erro no functions.php, um template quebrado ou incompatibilidade com a versão do PHP.

Passo 7 — Quando nada disso resolve

Plugins fora, tema padrão, memória alta e ainda branco? Restam duas frentes:

• Core corrompido: reinstale os arquivos do núcleo (wp core download --force no WP-CLI, ou suba uma cópia limpa do WordPress preservando wp-content e wp-config.php).
• Servidor: versão de PHP incompatível ou limite de recursos. O log de erros do servidor (no painel do host) mostra o erro de baixo nível — leve-o ao suporte.

Se o branco veio acompanhado de redirecionamentos ou um admin que você não criou, pode não ser um bug — trate como possível invasão e rode uma verificação de malware antes de seguir.

Quando o diagnóstico exige acesso ao servidor e versão de PHP, é o tipo de trabalho que a Pixelize resolve no serviço de WordPress Specialist.