WordPress Tela Branca da Morte: O que é?

Publicados: 2022-05-05

Se você usa o WordPress há algum tempo, provavelmente já encontrou a infame Tela Branca da Morte. De acordo com o Codex oficial, é um dos erros mais comuns do WordPress e pode acontecer enquanto você está logado em seu site, bem como enquanto você está tentando fazer login.

Neste post, explicarei por que a Tela Branca da Morte (ou WSOD para abreviar) acontece e como você pode resolvê-la rapidamente.

Por que a tela branca da morte acontece

De acordo com o WordPress Codex, a tela branca da morte é causada por problemas de banco de dados ou PHP. Geralmente acontece por alguns motivos:

  • Um dos plugins que você instalou está causando problemas de compatibilidade
  • Seu tema pode estar causando um problema de compatibilidade com outro tema, um plugin ou o próprio WordPress
  • Seu tema está ausente ou foi renomeado

Depois de saber quais são os principais culpados quando se trata de WSOD, fica muito mais fácil solucionar a raiz do problema e corrigi-lo.

Como corrigir rapidamente a tela branca da morte no WordPress

Existem várias etapas que você pode seguir para corrigir a tela branca da morte do WordPress e fazer com que seu site volte ao normal.

Desative seus temas e plugins

A primeira coisa que você deve fazer quando encontrar o WSOD é desabilitar seu tema ativo e os plugins para descartar quaisquer problemas ou conflitos de compatibilidade. Como mencionado acima, o WSOD pode ser causado por problemas de compatibilidade de temas e plugins. Esses problemas podem ocorrer quando você instala um novo plugin ou tema ou quando uma atualização para um tema ou plugin é lançada.

Para desabilitar os temas e plugins, você terá que acessar seu site via SFTP usando um programa como o FileZilla ou entrando no seu cPanel e indo ao seu Gerenciador de Arquivos.

Em seguida, navegue até a pasta de plugins e renomeie-a para algo como plugins_old. Isso desativará todos os plugins do seu site. Você pode então voltar e verificar se o WSOD foi resolvido. Se você conseguir acessar seu site, significa que um dos plugins causou o problema.

Você precisará renomear a pasta de plug-ins de volta para “plugins” e renomear cada pasta de plug-in dentro dela usando o mesmo padrão, um por um, até encontrar o plug-in que causou o problema. Depois de encontrar o plug-in incorreto, desinstale-o e encontre um substituto ou considere entrar em contato com o desenvolvedor e descobrir uma possível correção.

A mesma abordagem pode ser usada com seus temas. Se você tiver apenas um tema instalado, certifique-se de baixar o tema padrão do WordPress do repositório e instalá-lo para que o WordPress possa reverter para ele assim que você desativar seu tema ativo. Em seguida, repita as mesmas etapas que você fez com os plugins até encontrar o tema ofensivo.

Resolver erros de sintaxe

Se temas ou plugins não são o que está causando o WSOD, é hora de procurar em outro lugar. Às vezes, a tela branca da morte acontece quando você está editando arquivos de tema ou plugin e digita incorretamente a linha de código ou esquece de incluir um colchete de fechamento. Se isso acontecer e você encontrar a Tela Branca da Morte, precisará resolver esses erros de sintaxe.

Para resolvê-lo, acesse seu site via SFTP ou cPanel e remova o último bit de código que você digitou manualmente. Em seguida, verifique seu site para ver se ele está carregando corretamente. Se tudo funcionar, verifique seu código e certifique-se de digitá-lo corretamente.

Ativar a depuração

Outra maneira de corrigir o WSOD no WordPress é ativar a depuração. Como você deve ter adivinhado, você precisará acessar seu site por SFTP ou fazendo login no seu cPanel. Localize o arquivo wp-config.php e encontre a linha que diz:

 define( 'WP_DEBUG', false )

Altere a linha para que fique:

 define('WP_DEBUG', true) 

Salve-o e verifique seu site. Agora você deve ver mensagens de erro que fornecerão mais informações e indicarão a direção certa para encontrar a causa do erro de tela branca. Na maioria dos casos, você poderá determinar se um tema ou plugin está causando o problema. Você pode desabilitar e desinstalar o culpado e entrar em contato com o desenvolvedor para notificá-lo sobre o problema e descobrir quando uma correção será lançada.

Aumente os limites de memória

Em alguns casos, a Tela Branca da Morte acontece porque seu limite de memória se esgotou. Isso geralmente é causado por um plugin ou tema que possui um grande número de arquivos e seu servidor não consegue processá-los.

Para corrigir isso, você precisará aumentar o limite de memória do seu servidor. Existem várias maneiras de fazer isso, dependendo do seu ambiente de hospedagem:

  1. Acesse seu arquivo wp-config.php através de SFTP ou cPanel. Adicione a seguinte linha de código:
 define('WP_MEMORY_LIMIT', '64M');
  1. Se o acima não funcionar e você estiver usando uma empresa de hospedagem que usa servidores Apache, edite seu arquivo .htaccess para incluir a linha:
 php_value memory_limit 64M
  1. Se seu host estiver usando NGINX, você precisará editar seu arquivo php.ini para incluir a linha:
 memory_limit = 64M

Depois de aumentar o limite de memória, verifique seu site. Se o erro desaparecer, você pode continuar trabalhando em seu site normalmente. Se o erro persistir, você precisará aumentar mais o limite de memória ou entrar em contato com sua empresa de hospedagem para ajudá-lo a resolver o problema.

Verificar atualizações automáticas com falha

Por fim, a Tela Branca da Morte às vezes pode ser causada por um tema, plug-in ou atualização do núcleo que foi interrompido devido a um tempo limite do servidor. Embora não haja nada que você possa fazer para evitar o tempo limite do servidor, a primeira coisa que você deve fazer é acessar seu site via SFTP ou cPanel e excluir o arquivo .maintenance. Isso restaurará seu site e você poderá acessá-lo via wp-admin.

Você pode tentar realizar a atualização novamente ou atualizar manualmente temas, plugins e arquivos principais do WordPress.

Como reduzir as chances da tela branca do WordPress da morte acontecer novamente

A Tela Branca da Morte pode acontecer por vários motivos, mas existem algumas etapas que você pode seguir para reduzir as chances de encontrá-la.

  • Realize backups regulares do site e certifique-se de que eles sejam armazenados fora do local. Use serviços em nuvem como Dropbox ou um disco rígido externo e certifique-se de usar um plugin como UpdraftPlus para que você possa restaurar rapidamente o backup, se necessário.
  • Verifique cada linha de código que você está prestes a adicionar ao seu site ou, melhor ainda, crie um ambiente de teste para testar as alterações antes de adicioná-las ao seu site ativo
  • Em uma nota semelhante, considere usar um site de teste para testar atualizações de plugins e temas antes de atualizá-los em seu site
  • Use uma empresa de hospedagem que forneça suporte 24 horas por dia, 7 dias por semana, para que você possa obter ajuda com seu site se nenhuma das etapas acima funcionar
  • Considere usar um plug-in como o User Activity Log para manter um registro detalhado de alterações, atualizações e outras atividades em seu site

Pensamentos finais

O WordPress White Screen of Death não é uma experiência divertida. Embora irritante, existem etapas que você pode seguir para solucionar e corrigir o problema. Use as etapas descritas neste artigo para ajudá-lo a diagnosticar o que causou a Tela Branca da Morte em seu site e resolvê-lo rapidamente.