WordPress Tela Branca da Morte: O que é?
Publicados: 2022-05-05Se 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:
- Acesse seu arquivo wp-config.php através de SFTP ou cPanel. Adicione a seguinte linha de código:
define('WP_MEMORY_LIMIT', '64M');
- 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
- 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.