Tela branca da morte no WordPress: causas e solução passo a passo

Você abre o seu site WordPress e não aparece nada: uma tela completamente em branco, sem a sua página, sem mensagem de erro, sem sequer o logotipo. Não carrega a home e, às vezes, nem o painel de administração. É a temida tela branca da morte (White Screen of Death), e o seu maior problema é justamente esse: ela não diz o que deu errado.

Por que aparece

A tela em branco quase sempre significa que o PHP, a linguagem em que o WordPress roda, foi interrompido no meio do caminho e parou de gerar a página. As causas mais frequentes são um plugin ou um tema com código incompatível (sobretudo logo depois de atualizar ou instalar algo), um erro de programação em um arquivo do tema, ou o esgotamento do limite de memória PHP que a hospedagem atribui ao site. Também pode ser disparada por uma mudança na versão do PHP do servidor que deixa um plugin antigo obsoleto. A pista fundamental é quando começou: se foi imediatamente depois de mexer em algo, geralmente é aí que está o culpado.

Como diagnosticá-la e resolvê-la

  1. Veja se é o site inteiro ou só uma parte. Se o painel /wp-admin abre mas a parte pública não, o problema quase certamente está no tema ou em um plugin. Se nada abre, é algo mais geral.
  2. Desative os plugins. Se você consegue entrar no painel, desative todos de uma vez e reative-os um a um até a falha reaparecer: o último é o responsável. Se não consegue entrar, faça o mesmo por FTP renomeando a pasta wp-content/plugins, o que desativa todos à força.
  3. Teste com um tema padrão. Se não eram os plugins, mude temporariamente para um tema oficial do WordPress (Twenty Twenty e similares). Se o site voltar a funcionar, o problema estava no seu tema.
  4. Ative o modo debug. No arquivo wp-config.php coloque WP_DEBUG como true para que o WordPress mostre o erro real em vez da tela em branco. Essa mensagem costuma indicar o arquivo e a linha exatos da falha.
  5. Aumente o limite de memória PHP. Se o erro mencionar memória esgotada, adicione define(‘WP_MEMORY_LIMIT’, ‘256M’); no wp-config.php ou aumente o limite pelo painel da hospedagem.
  6. Verifique a versão do PHP. No painel da hospedagem, confirme que você está em uma versão do PHP compatível com o seu WordPress e os seus plugins; um salto de versão mal acompanhado é uma causa habitual.

A boa notícia é que a tela branca quase nunca implica perda de dados: os seus textos e imagens continuam guardados no banco de dados, é um problema de execução que tem solução. A má é que mexer no wp-config.php ou entrar por FTP com o site fora do ar e clientes esperando não é o melhor momento para aprender na prática. Se você prefere não se arriscar, na HostalCubo oferecemos hospedagem gerenciada e suporte técnico: fazemos backups, monitoramos o site e resolvemos esse tipo de queda antes que ela custe uma venda a você.

Fontes: documentação oficial do WordPress sobre depuração (WP_DEBUG) e guias técnicos de diagnóstico da tela branca da morte.

Posts Similares