O que fazer quando o WordPress exibe uma tela branca (White Screen of Death)

O que é a Tela Branca da Morte (e por que ela não é o fim do mundo)

Calma, respira. 🙂 Você entrou no seu site e, em vez do WordPress de sempre, encontrou uma página completamente branca, em silêncio, sem nenhuma mensagem de erro. Isso tem nome — a comunidade WordPress apelidou carinhosamente de White Screen of Death (WSOD), ou "Tela Branca da Morte".

O nome assusta, mas na prática é só o WordPress avisando, do jeito mais tímido possível, que algum código travou no meio do caminho — geralmente um plugin, um tema ou um limite de recursos do PHP. Na maioria dos casos, seus arquivos e seu banco de dados continuam intactos. Vamos resolver juntos, passo a passo.

Dica da Sensei: antes de qualquer coisa, tire um respiro e não saia apagando arquivos "no escuro". Tela branca tem causa raiz — e ela quase sempre está identificada em 2 ou 3 passos.

As causas mais comuns

• Um plugin com erro — geralmente depois de instalar ou atualizar algum.
• Um tema com problema — código incompatível com a versão atual do PHP ou do WordPress.
• Limite de memória do PHP estourado — o site "pediu" mais memória do que o processo conseguiu entregar.
• Falha na conexão com o banco de dados — nesse caso a tela branca às vezes vem acompanhada da mensagem "Error establishing a database connection".

Passo a passo para resolver

Passo 1: Descubra se é só a área pública ou o painel também

Tente acessar o painel administrativo do seu site (o endereço termina em /wp-admin). Se o painel abre normalmente e só a parte pública (o site que os visitantes veem) está branca, o problema quase sempre é do tema. Se os dois estão brancos, o suspeito principal é um plugin ou um limite de memória.

Passo 2: Ative o modo de depuração para ver a mensagem escondida

A tela fica branca porque o WordPress, por padrão, esconde os erros dos visitantes. Você pode pedir pra ele te mostrar o que está acontecendo. No Gerenciador de Arquivos do seu cPanel, abra o arquivo wp-config.php (ele fica na pasta raiz do seu site, geralmente public_html) e procure a linha:

define( 'WP_DEBUG', false );

Troque false por true, salve, e recarregue seu site. Agora, em vez da tela branca, deve aparecer uma mensagem indicando exatamente qual arquivo ou plugin está dando problema. Depois de resolver, não esqueça de voltar para false — deixar ativado expõe detalhes técnicos do site para qualquer visitante.

Passo 3: Desative os plugins, um de cada vez (ou todos de uma vez)

Ainda pelo Gerenciador de Arquivos, navegue até a pasta wp-content/plugins. Renomeie essa pasta para algo como plugins-teste (basta clicar com o botão direito no arquivo/pasta e escolher "Renomear"). Isso desativa todos os plugins de uma vez, sem apagar nada.

1. Recarregue o site. Se voltou ao normal, o culpado é um plugin.
2. Renomeie a pasta de volta para plugins.
3. Entre em wp-admin > Plugins e reative um por um, recarregando o site a cada ativação, até encontrar o que causa o problema.
4. Desative (ou atualize, se houver uma versão nova) o plugin culpado.

Passo 4: Volte ao tema padrão do WordPress

Se o passo anterior não resolveu, o suspeito agora é o tema. Pelo Gerenciador de Arquivos, vá até wp-content/themes e renomeie a pasta do seu tema atual (ex.: renomeie meu-tema para meu-tema-teste). O WordPress automaticamente volta para um tema padrão. Se o site voltar ao ar, o problema está no tema — vale atualizá-lo ou trocar por uma versão mais recente.

Passo 5: Verifique se não é a conexão com o banco de dados

Se a mensagem de depuração (Passo 2) mencionar banco de dados, ou se aparecer o aviso "Error establishing a database connection", confira em Bancos de Dados MySQL no cPanel se o banco e o usuário do seu site ainda existem e estão vinculados corretamente. As credenciais de acesso (nome do banco, usuário e senha) ficam registradas no mesmo wp-config.php do Passo 2 — compare com o que está no cPanel.

Dica da Sensei: se você não mexeu em nada e o erro de banco de dados apareceu do nada, não force alterações nas credenciais por conta própria — chame o suporte antes de trocar senha de banco, pra não gerar um novo problema em cima do primeiro.

Passo 6: Se nada disso resolver, restaure um backup

Como último recurso, o cPanel guarda ferramentas de Backup que permitem restaurar seu site (ou só o banco de dados) para um momento anterior ao problema.

Quando chamar o suporte da GeHost

Se você seguiu os passos acima e ainda assim a tela continua branca, ou se não se sente confortável mexendo em arquivos do site, pode chamar a gente sem receio. Leve com você:

• O nome do domínio afetado;
• Se possível, a mensagem de erro que apareceu depois de ativar o WP_DEBUG (Passo 2);
• Quando o problema começou (por exemplo, logo após atualizar algum plugin ou tema).

Consulte as condições de suporte do seu plano diretamente no painel do cliente. Estamos aqui pra ajudar — tela branca acontece, e resolver ela é só mais um dia de trabalho pra gente. 🌱