WordPress 0 visualizações

Como resolver a tela branca da morte (WSOD) no WordPress

Ver no WHMCS

Tela Branca da Morte no WordPress: o guia da Sensei pra você não entrar em pânico 🥋

Oi! Aqui é a Sensei da GeHost. Se seu site abriu uma página completamente branca, sem nenhuma mensagem, sem nada — calma, respira. Isso tem nome (o pessoal chama de WSOD, "White Screen of Death") e, na grande maioria das vezes, é simples de resolver. Vamos passo a passo, do jeito mais tranquilo possível.

Por que isso acontece?

A tela branca aparece quando o WordPress encontra um erro tão sério no meio do carregamento que ele "trava" antes mesmo de conseguir mostrar a mensagem de erro na tela. As causas mais comuns são:

  • Um plugin que acabou de ser instalado ou atualizado e não é compatível com algo no seu site;
  • Um tema com algum código quebrado;
  • O site estourando o limite de memória do PHP;
  • Algum arquivo do WordPress corrompido ou alterado incorretamente.
Dica de ouro da Sensei: antes de mexer em qualquer coisa, sempre que possível faça um backup. Assim, se algo não sair como esperado, você volta pro estado anterior numa boa.
Tela de Backup do cPanel com opções de backup completo e parcial

Passo 1 — Acesse o cPanel

Pra investigar e corrigir a tela branca, você vai precisar entrar no cPanel da sua hospedagem (o painel de controle do seu site). O acesso fica em painel.gehost.com.br.

Tela de login do cPanel com campos de usuário e senha

Passo 2 — Desative os plugins (o suspeito nº 1)

Na maioria dos casos, a tela branca aparece logo depois de instalar ou atualizar um plugin. Como o site está fora do ar, você não consegue desativar o plugin pelo painel do WordPress normalmente — então vamos fazer isso "por fora", pelo Gerenciador de Arquivos do cPanel:

  1. No cPanel, abra o Gerenciador de Arquivos (File Manager);
  2. Entre na pasta do seu site, geralmente public_html;
  3. Vá até wp-content e localize a pasta plugins;
  4. Clique com o botão direito na pasta plugins e escolha Renomear (por exemplo, para plugins-desativado).
Gerenciador de Arquivos do cPanel mostrando a árvore de pastas

Ao renomear a pasta, o WordPress automaticamente desativa todos os plugins (sem perder nenhuma configuração). Teste o site de novo:

  • Voltou ao normal? Ótimo, o problema era um plugin! Renomeie a pasta de volta para plugins e vá ativando os plugins um por um pelo painel do WordPress até achar o culpado (deixe ele desativado ou procure uma versão mais nova).
  • Continua branco? Siga pro próximo passo.

Passo 3 — Volte ao tema padrão

Se desativar os plugins não resolveu, o problema pode estar no tema. Ainda dentro de wp-content, abra a pasta themes e renomeie a pasta do tema que está ativo no seu site (por exemplo, de meu-tema para meu-tema-old). Isso faz o WordPress cair automaticamente em um tema padrão. Teste o site novamente.

Passo 4 — Aumente o limite de memória do PHP

Às vezes a tela branca acontece porque o site "pediu" mais memória do que o limite configurado permite. Você pode aumentar esse limite direto no arquivo wp-config.php (na raiz do seu site, pelo Gerenciador de Arquivos):

  1. Clique com o botão direito em wp-config.php e escolha Editar;
  2. Procure a linha /* Isso é tudo, pode parar de editar! */;
  3. Logo antes dela, adicione a linha: define('WP_MEMORY_LIMIT', '256M');
  4. Salve o arquivo e teste o site.

Se mesmo assim continuar dando erro de memória, o limite pode já estar no máximo permitido pelo seu plano — nesse caso, dá uma olhada no seu plano atual no painel.gehost.com.br ou fale com a gente pra te orientar.

Passo 5 — Ative a exibição de erros (pra diagnosticar com precisão)

Se você quiser ver exatamente qual é o erro (em vez da tela branca), pode ativar temporariamente o modo debug no wp-config.php, no mesmo lugar do passo anterior:

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

Isso vai mostrar na tela qual arquivo e qual linha estão causando o problema — uma informação valiosa se você precisar do nosso suporte depois. Importante: depois de resolver, volte esse valor para false, porque deixar erros visíveis publicamente não é uma boa prática de segurança.

Passo 6 — Nada resolveu? Chama a gente

Se você seguiu todos os passos e a tela branca continua aparecendo, pode ser algo mais específico (um arquivo core corrompido, um conflito mais profundo). Não se preocupe — abra um chamado no painel.gehost.com.br contando o que você já tentou, e nosso time dá uma olhada com carinho.

Lembrete: todo serviço entregue pela GeHost já vem com 30 dias de suporte grátis após a entrega. E lembre-se — sempre que for mexer em arquivos do seu site, um backup antes é sempre a atitude mais sábia. 🙏

Foi útil? Espero que sim! Qualquer dúvida, é só chamar — a Sensei (e todo o time GeHost) está por aqui. 😊

Precisa de Ajuda?

Nossa equipe está pronta para resolver suas dúvidas.