Nada é pior do que navegar para o seu site WordPress e de repente ser encontrado com a Tela Branca da Morte (WSoD). Este erro torna o seu site inacessível tanto para administradores quanto para visitantes.
A WSoD também pode ser incrivelmente frustrante, devido à falta de informações que apontem para uma possível causa ou solução. No entanto, é também um dos erros mais comuns do WordPress. Por isso, embora preocupante, na maioria dos casos é resolúvel.
Neste post, vamos explicar o que é a WordPress WSoD e quais são as suas causas comuns. O mais importante é que vamos lhe guiar por nove soluções potenciais para que seu site volte a funcionar o mais rápido possível.
Vamos começar!
Prefere assistir à versão em vídeo?
O que é a Tela Branca da Morte WordPress?
Fiel ao seu nome, o WordPress White Screen of Death (também conhecido como “WSoD”) ocorre quando, ao invés da página web que você está tentando acessar, você se depara com uma tela branca em branco em seu lugar.
Dependendo do navegador que você estiver usando, você pode receber diferentes mensagens de erro. Abaixo está um exemplo no Google Chrome, que inclui um aviso de erro HTTP 500 “Esta página não está funcionando e não consegue lidar com a solicitação”:
Agora vamos dar uma olhada na Tela Branca da Morte no Mozilla Firefox:
Como você pode ver, é apenas uma simples tela branca. Ela não contém nenhum erro útil ou mensagens de aviso.
A tela branca da morte do WordPress é quase sempre causada por erros de código PHP ou pelo esgotamento do limite de memória.
Outra causa possível é um tema ou plugin defeituoso. Este último é provavelmente o problema se o frontend do site estiver em baixo, mas sua área de administração do WordPress estiver em cima. Para verificar rapidamente se o painel do seu site está funcionando, basta navegar para yourdomain.com/wp-admin.
Então, como você conserta a WSoD? Que bom que você perguntou!
Como Fixar a Tela Branca da Morte do WordPress (9 Métodos)
Quando você experimentar o WordPress White Screen of Death, sua prioridade será consertá-lo o mais rápido possível. Com isso em mente, vamos dar uma olhada em nove soluções possíveis que você pode usar para resolvê-lo.
1. Desabilite seus Plugins WordPress
Uma das formas mais fáceis e comuns de consertar o WordPress WSoD é simplesmente desativar todos os seus plugins. Muitas vezes, um site cai devido a uma atualização ruim do plugin.
Se você ainda pode acessar sua área administrativa, uma maneira rápida de fazer isso é navegar para Plugins a partir do painel, selecionar todos os plugins, e então clicar em Desativar no menu suspenso Ações em massa:
Isto irá desabilitar todos os seus plugins.
Se isso resolver o problema, você vai precisar encontrar o culpado. Para isso, você pode começar a ativar os plugins um a um, recarregando o site após cada ativação. Quando seu frontend cair, você terá encontrado o plugin mal-comportado.
Você pode então contactar o desenvolvedor do plugin para obter ajuda ou publicar um ticket de suporte no Diretório de Plugins do WordPress.
Se você não puder fazer login no WordPress admin, você pode usar um cliente FTP (File Transfer Protocol) para acessar o diretório de arquivos do seu site.
Sob a pasta wp-content do seu diretório raiz, localize a pasta plugins. Renomeie-a para algo do tipo “plugins_old”:
Em seguida, verifique o seu site novamente no frontend. Se isso funcionar, você precisará testar cada plugin um a um. Renomeie sua pasta de plugins de volta para “plugins”, e então renomeie individualmente cada pasta de plugins dentro dela até localizar o plugin defeituoso.
2. Mude para um Tema Padrão do WordPress
Se o problema não for um plugin, seu tema WordPress pode ser a causa da Tela Branca da Morte. Para ver se este é o problema, você pode substituir o seu tema mudando para um padrão.
Se você pode acessar sua área administrativa, acesse Appearance > Temas em seu painel de controle. Localize e ative um tema padrão do WordPress, como Twenty Twenty:
Depois, teste o seu site novamente. Se funcionar, você saberá que o problema está no seu tema.
Se você não consegue acessar seu painel, o processo é o mesmo que com os plugins.
Use FTP para acessar os arquivos do seu site, e renomeie sua pasta wp-content/temas para outra coisa:
O WordPress irá então reverter para o último tema padrão, que é muito provavelmente o Twenty Twenty. Se você não tiver nenhum outro tema, você pode baixar um do Diretório de Temas do WordPress e depois carregá-lo para sua pasta de temas.
Depois disso, vá em frente e confira novamente o seu site. Se funcionar, talvez o seu tema tenha tido um conflito ou uma atualização ruim. Se este for o caso, talvez você precise pedir ajuda ao desenvolvedor ou considerar a possibilidade de trocar de tema
3. Clear Browser e Cache do Plugin do WordPress
Se você tem acesso ao backend do seu site WordPress mas ainda está vendo a WSoD no frontend, isso pode ser devido a um problema com o seu cache.
Para consertá-lo, tente limpar o cache do seu navegador web e seu plugin de cache do WordPress (assumindo que você tenha um instalado).
Se você tem um plugin de cache instalado no seu site WordPress, como WP Rocket ou WP Super Cache, a maioria oferece uma maneira rápida de limpar o cache através da página de configurações do plugin.
Usando o WP Super Cache como exemplo, no seu painel do WordPress você navegaria para Configurações > WP Super Cache > Excluir Cache:
Como Limpar Sua Cache do MyKinsta
Se você é um usuário Kinsta, há também uma maneira fácil de limpar seu cache usando o MyKinsta. Para fazer isso, faça o login na sua conta. Clique em Ferramentas, seguido por Limpar cache sob a seção Site Cache:
Uma vez que você esvaziar o cache, salve suas alterações. Depois revisite o seu site para ver se isso corrigiu o problema. Caso contrário, é hora de passar para outra solução.
4. Ativar o Modo de Depuração
Se você ainda estiver vendo a tela branca da morte do WordPress, a área administrativa não está funcionando, ou você acha que encontrou o problema mas quer cavar mais fundo, você pode habilitar o modo de depuração. Isto mostrará quaisquer erros que estejam ocorrendo no seu site.
Para habilitar a depuração, você precisará abrir o arquivo wp-config.php da sua instalação do WordPress. Dentro dele você deve encontrar a seguinte linha:
define( 'WP_DEBUG', false );Mude “falso” para “verdadeiro”, e depois recarregue o seu site. Se esta linha não existir, você pode adicioná-la ao topo do arquivo.
Ao invés da tela branca, você receberá uma tela branca e algumas mensagens de erro. Isto não é uma grande melhoria, mas é apenas um começo. A mensagem de erro WSoD deve indicar em qual arquivo o problema se originou, desta forma:
Cannot redeclare get_posts() (previously declared in
/var/www/html/wordpress/wp-includes/post.php:1874) in
/var/www/html/wordpress/wp-content/plugins/my-test-plugin/my-test-plugin.php on line 38Você pode ver no final deste exemplo mensagem que o problema está na linha 38 de um plugin chamado my-test-plugin. Portanto, a desativação desse plugin deve resolver o problema.
Se você não vir nenhum erro depois de habilitar o modo de depuração, você pode precisar chegar ao seu host web. É possível que o debug não esteja configurado corretamente no seu servidor.
Os clientes Kinsta têm a opção de utilizar uma ferramenta de depuração integrada. A partir do painel do MyKinsta, clique no nome do seu site seguido de Ferramentas. Na depuração do WordPress, selecione Habilitar:
Você pode então acessar seu log de erros na seção Logs do seu painel do MyKinsta, e explorá-los para saber mais sobre o problema.
Tenha em mente que ter o modo de depuração ligado pode expor algumas das informações do seu site a usuários não aprovados. Portanto, certifique-se de sempre desligar o modo quando terminar de usá-lo.
5. Aumente seu limite de memória
Se você ainda vir a temida página vazia da WSoD depois de tentar algumas das soluções acima, ou se você receber um erro reclamando sobre limites de memória ou memória esgotada, você precisará atribuir mais memória para a aplicação.
Isto pode ser feito através do arquivo wp-config.php em muitas instalações do WordPress. Abra o arquivo e adicione o seguinte código:
define('WP_MEMORY_LIMIT', '64M');Se isto parece não funcionar, você tem algumas opções. Em um ambiente normal, você pode usar seu arquivo .htaccess para aumentar o limite de memória. Basta adicionar a seguinte linha:
php_value memory_limit 64MSe você não consegue acessar seu arquivo .htaccess, você pode usar seu arquivo php.ini para aumentar o limite de memória.
Para fazer isso, conecte-se ao seu servidor via FTP. No diretório raiz do seu site, procure o arquivo php.ini. Uma vez localizado, adicione a seguinte linha em qualquer lugar dentro do arquivo:
memory_limit = 64MSe você ainda estiver sem memória e precisar atribuir mais, pode haver um problema dentro da sua aplicação. Talvez o seu tema ou um de seus plugins esteja usando uma quantidade desordenada de recursos.
Neste ponto, você pode querer contratar um desenvolvedor para dar uma olhada. Mesmo o seu host pode ser capaz de ajudar, mostrando-lhe os logs SQL e outras estatísticas de recursos para o seu site.
6. Verifique as questões de permissão de arquivos
Outra causa potencial da WSoD é a permissão e questões de propriedade. É possível resolver este problema por conta própria. No entanto, a menos que você realmente saiba o que está fazendo, nós desaconselhamos isso, pois você pode inadvertidamente criar vulnerabilidades que os atacantes podem explorar.
Quando se trata de permissões do WordPress, há três regras simples a seguir:
- Os arquivos devem ser configurados para 664 ou 644.
- As pastas devem ser configuradas para 775 ou 755.
- O arquivo wp-config.php deve ser configurado para 660, 600, ou 644.
Se você tem acesso SSH ao seu servidor, você pode aplicar as regras apropriadas com o seguinte comando, executando-o a partir do diretório raiz do WordPress:
sudo find . -type f -exec chmod 664 {} +
sudo find . -type d -exec chmod 775 {} +
sudo chmod 660 wp-config.phpSe você não tem certeza de como fazer isso ou está um pouco intimidado, vá em frente e peça ajuda ao seu web host.
7. Verifique se há problemas de atualização automática falhados
Às vezes o WordPress esbarra em um problema com atualizações, como por exemplo, quando o servidor acaba. Na maioria das vezes, este problema se resolve automaticamente. Entretanto, em alguns casos raros, ele pode levar à Tela Branca da Morte do WordPress.
A primeira coisa que você deve fazer é ir ao seu diretório raiz do WordPress e ver se há um arquivo .maintenance (o nome do arquivo também pode ser abreviado).
O que você gostaria de fazer é tentar apagar esse arquivo e carregar o seu site novamente.
Se a atualização foi bem sucedida, mas o WordPress não conseguiu remover este arquivo automaticamente, tudo deve voltar ao normal.
Se a atualização não foi concluída, ela poderá ser reiniciada automaticamente, caso em que as coisas devem voltar ao normal da mesma forma.
Se tudo mais falhar, siga o procedimento de atualização manual recomendado para o WordPress, que deve resolver o problema de uma vez por todas.
8. Resolver Erros de Sintaxe ou Restaurar um Backup
Outra causa comum para o WordPress WSoD é quando você está editando o código no seu site WordPress e acidentalmente digita algo errado ou usa a sintaxe errada.
Um personagem no lugar errado pode derrubar todo o seu site, e é por isso que você nunca deve editar o código no seu site de produção ao vivo.
Não se preocupe, porém. Você sempre pode se conectar ao seu site via FTP e reverter a mudança que você fez manualmente. Se você não sabe qual mudança causou o problema, é aqui que ter backups do WordPress no local vem a calhar.
Aqui em Kinsta, você pode restaurar seu site para um ponto anterior com um único clique. Para fazer isso, entre no seu painel do MyKinsta e navegue até os Backups:
Tenha em mente que se você habilitou o modo de depuração no WordPress antes, pode haver também uma mensagem de erro indicando um erro de sintaxe parse. Se este for o caso, ele deve dizer exatamente onde encontrar o código do problema.
9. Aumentar a capacidade de processamento de texto em PHP
Neste ponto, se a WSoD ainda não foi resolvida, há um truque adicional que você pode tentar. Em raras ocasiões, este problema pode ocorrer por causa de uma página ou post é particularmente longo.
Se este for o caso, você pode tentar ajustar a capacidade de processamento de texto PHP no seu site, aumentando os limites de retrocesso e recursividade. Para fazer isso, cole o seguinte código dentro do seu arquivo wp-config.php:
/* Trick for long posts /
ini_set('pcre.recursion_limit',20000000);
ini_set('pcre.backtrack_limit',10000000);Uma vez adicionado este código, salve suas alterações. Depois atualize seu site para ver se ele está funcionando.
Sumárió
A tela branca da morte do WordPress pode ser incrivelmente frustrante, até mesmo assustadora. Há uma série de coisas que podem dar errado, mas felizmente a situação geralmente não é tão ruim quanto parece.
Um simples plugin e/ou verificação temática deve corrigir o problema da WSoD na maioria dos casos. Familiarizar-se mais com o modo de depuração do WordPress irá definitivamente lançar mais luz sobre o problema e guiá-lo.
Se você encontrou qualquer outra situação de morte no WordPress White Screen of Death, deixe-nos saber para que possamos aprender com ela e compartilhar a experiência!
Hi, my name is Daniel, I'm the CTO here at Kinsta. You may know me from Smashing Magazine, WPMU Dev, Tuts+ and other WordPress/Development magazines. Aside from WordPress and PHP I spend most of my time around Node, React, GraphQL and other technologies in the Javascript space.
When not working on making the best hosting solution in the Universe I collect board games, play table football in the office, travel or play guitar and sing in a pretty bad band.
Adorei seu conteúdo Parabéns, bem completo e dinâmico. Era exatamente o que eu estava buscando na internet e todas as minhas dúvidas foram tiradas aqui. Muito sucesso e gratidão!