É frustrante acessar o site WordPress e notar que nada aparece, apenas uma tela branca, também conhecida como Tela Branca da Morte (WSoD). Esse erro pode tornar seu site completamente inacessível ou apenas parte dele.
Apesar de ser uma situação desesperadora, principalmente para quem não está familiarizado com administração de sites WordPress, saiba que a tela branca no WordPress é um erro comum e fácil de resolver.
A primeira dica é não se desespere, você vai conseguir recuperar o acesso ao site WordPress. Neste tutorial vamos mostrar passo a passo como corrigir o erro da tela branca no WordPress e explicar o porquê dele ocorrer com tanta frequência.
O que é Tela Branca do WordPress?
A tela branca do WordPress é o nome dado quando o site, em vez de carregar a página, exibe apenas uma tela em branco, sem nenhuma informação ou mensagem de erro.
Dependendo do navegador, pode ser exibida uma mensagem de erro informando que o site não está funcionando corretamente. Ou uma mensagem como “Ah, não” ou “Não foi possível carregar este site”.
Independentemente da mensagem de erro, ou se for apenas exibida a tela branca no WordPress, o método para corrigir o problema do WordPress vai ser o mesmo, basta seguir os passos que mostraremos mais abaixo.
Porque ocorre o erro da Tela Branca no WordPress?
A tela branca da morte do WordPress é exibida sempre que ocorre um erro no site. Isso é, quando o WordPress não consegue processar a solicitação do usuário devido algum erro ou falha, ele mostra uma página em branco sinalizando que há algum problema no site.
A causa da tela branca WordPress pode ser variada, não existe apenas um motivo para esse erro ocorrer. É necessário iniciar uma investigação para encontrar a causa exata do problema.
No geral a tela branca é causada por incompatibilidade entre plugins e temas. Ou a versão do PHP não está de acordo com os requisitos para o correto funcionamento do site WordPress.
11 Formas de corrigir a tela branca no WordPress
Para corrigir a tela branca do WordPress é preciso seguir os passos abaixo, até encontrar o problema. Isso é importante porque o erro pode ser causado por diferentes motivos e é preciso analisar cada um deles até encontrar a real causa do problema.
1. Desabilitar plugins do WordPress
Uma tática muito usada para corrigir o erro da tela branca no WordPress é desativar todos os plugins. Ao fazer isso o site pode ficar “desconfigurado”, principalmente se utilizar plugins construtores de páginas como o Elementor ou WPBakery.
Mas ainda assim é importante desativar todos os plugins para ter certeza que nenhum dos plugins instalados no site está ocasionando a tela branca do WordPress.
Se ao desativar todos os plugins, o site voltar a ser exibido (mesmo que desconfigurado) é sinal que algum plugin está ocasionando erros no site e, consequentemente, causando a tela branca do WordPress.
Caso o painel de administração esteja funcionando, siga os passos abaixo para desativar todos os plugins:
- Acesse o painel de administração do WordPress.
- No menu lateral, clique em “Plugins”.
- Selecione todos os plugins ativos do site.
- Em “Ações em massa”, selecione a opção “Desativar”.
- Depois clique em “Aplicar”.
Agora tente acessar o site novamente para ter certeza que a tela branca parou de ocorrer no WordPress.
Caso você não tenha acesso ao painel de administração, é possível desativar todos os plugins utilizando um gerenciador de arquivos da sua hospedagem WordPress ou através de um cliente FTP.
- Abra o cliente FTP ou gerenciador de arquivos.
- Procure pela pasta “public_html” ou “www”.
- Depois abra a pasta “wp-content”.
- Procure pela pasta “plugins” e a renomeie para “plugins-old”.
Tente acessar o site novamente. Se o WordPress tela branca parou de ocorrer é porque estava sendo causado por algum plugin. Renomeie a pasta de volta para “plugins”, mas antes certifique-se que o WordPress já não criou outra pasta chamada “plugins”. Caso ele tenha criado basta remover a pasta em branco e renomear a pasta para o nome antigo.
Agora com o WordPress funcionando acesse o painel de controle, clique em “plugins” e ative os plugins um por um, sempre verificando se o site continua funcionando. Realize esse procedimento até encontrar o plugin que vai fazer o site parar de funcionar.
Caso você tenha desativado todos os plugins e o site continue com problemas, é porque a falha não está sendo causada por eles. Então siga as próximas etapas para resolver o problema da tela branca.
2. Ativar modo de depuração
Ativar o modo de depuração do WordPress possibilita obter uma direção de onde procurar o problema. A depuração nada mais que é gravar um log (registro) de todos os erros que ocorrem no servidor.
A partir da mensagem de erro retornada pelo servidor é possível encontrar “pistas” sobre o causador do erro. Para um usuário experiente a análise de log de erros mostra claramente qual é o problema, mas para um usuário leigo interpretar essas mensagens pode não ser uma tarefa fácil.
Para ativar o modo depuração do WordPress, siga os seguintes passos:
- Abra um gerenciador de arquivos ou cliente FTP.
- Procure pela pasta “public_html” ou “www”.
- Clique com o botão direito do mouse sobre o arquivo “wp-config.php” e depois em “Editar”.
- Localize a linha de códigoe mude para “true”, conforme imagem abaixo.
define( 'WP_DEBUG', false );
Após essa alteração o modo de depuração do WordPress está ativo. Todas as mensagens de erros serão gravas dentro do arquivo “debug.log”, localizado na pasta “wp-content”.
Abra esse arquivo usando um gerenciador de arquivos da sua hospedagem WordPress ou cliente FTP.
Procure por linhas de erros que comecem com “PHP Fatal error”. Elas indicam o erro que pausou a execução do script. Erros começando com “PHP Notice” podem ajudar a entender o problema também, mas geralmente não são a causa da interrupção do script e da tela branca.
3. Aumentar limite de memória do WordPress
É comum a tela branca ser ocasionada por falta de memória no servidor. Se durante o processamento da página faltar memória, o processo é encerrado de forma abrupta e nenhuma informação é retornada para o usuário.
Nesse caso, aumentar o limite de memória pode resolver o problema e fazer com que o problema da tela branca seja solucionado.
Para aumentar o limite de memória do WordPress siga os passos abaixo:
- Abra um cliente FTP ou gerenciador de arquivos.
- Procure pela pasta “public_html” ou “www”.
- Localize o arquivo wp-config.php.
- Clique com o botão direito sobre o arquivo e depois em “Editar”.
- Adicione o código abaixo dentro do arquivo citado anteriormente:
define('WP_MEMORY_LIMIT','256m'); - Salve e feche o arquivo editado.
Tente acessar seu site WordPress para verificar se o problema foi corrigido. Se o problema ainda persistir siga os próximos passos.
4. Alterar versão do PHP
A versão incorreta do PHP pode gerar falhas em temas, plugins e até no próprio WordPress. Cada caso necessita de uma solução diferente, mas no geral ao selecionar a versão 7.2 do PHP todo o ecossistema do WordPress funciona sem erros.
Porém, em alguns casos bem raros pode ser necessário realizar o downgrade da versão do PHP. Isso significa que você vai ter que utilizar uma versão mais antiga e insegura do PHP para que o site volte a funcionar corretamente.
Importante ressaltar que, mesmo que você não tenha alterado recentemente a versão do PHP, não é raro os casos da empresa de hospedagem alterar a versão do PHP por conta próprio sem avisar ao cliente.
5. Efetuar limpeza de cache
Caso seu site possua algum plugin de cache ou a sua hospedagem WordPress ofereça cache, tente efetuar a limpeza desses caches para garantir que eles não estão causando problemas no WordPress.
O procedimento pode variar bastante de acordo com a hospedagem WordPress utilizada e plugins de cache instalados. No geral, para limpeza de cache você precisa acessar o painel de administração, e dentro da configuração do plugin de cache utilizado por seu site, procurar por uma opção de “limpeza de cache” ou “Clear cache”.
No caso de caches de servidor, que são gerenciados pela hospedagem WordPress, você deve acessar o painel de administração da hospedagem, e procurar alguma opção de limpeza de cache.
6. Atualize o WordPress, plugins e temas
Outra causa comum para a tela branca do WordPress é a incompatibilidade de plugins. Alguns plugins podem parar de funcionar de uma hora para a outra simplesmente por causa de mudanças realizados no core do WordPress.
Nesse caso, atualizar todos os plugins e temas pode resolver o problema. Mas não se esqueça de realizar o backup completo do site para garantir que não terá problemas ao tentar atualizar os plugins e temas do WordPress.
Uma dica importante, sempre atualize primeiro os temas, depois os plugins e por último o WordPress. É comum os desenvolvedores lançarem atualizações para plugins e temas funcionarem corretamente em novas versões do WordPress. É por isso que eles devem ser atualizados antes mesmo que próprio WordPress.
7. Alterar para tema padrão WordPress
Algumas vezes a causa da tela branca WordPress pode ser a incompatibilidade do tema com o WordPress. Isso costuma ocorrer depois de uma atualização ou mudança nas configurações do servidor.
Para ter certeza que não está sendo causado pelo tema, é importante alterar o tema ativo do WordPress. De preferência para ativar o tema padrão Twenty Fifteen ou Twenty Fourteen, ambos desenvolvidos pela mesma equipe que criou o WordPress.
Se ao mudar para o tema padrão a tela branca ser solucionada, é sinal que você precisa trocar de tema para que o site continue a funcionar corretamente. Outra dica é procurar na internet ou fóruns de suporte do tema utilizado possíveis problemas de incompatibilidade com a versão atual do WordPress.
8. Ativação de novos módulos
Existe a possibilidade do servidor da hospedagem WordPress está com algum módulo faltando. Isso pode ocorrer nas melhores empresas de hospedagem.
Portanto, se ao ativar o modo de debug do WordPress for exibida a mensagem de falha ao carregar algum módulo. Algo semelhante a “Library not loaded: /usr/local/lib/...” é indicativo que um módulo precisa ser ativado ou instalado pelo administrador do servidor.
Isso é, se você tem uma hospedagem WordPress ou hospedagem compartilhada, entre em contato com o suporte para verificar a possibilidade ativar o módulo faltante.
No painel de administração da hospedagem também pode existir a possibilidade de ativar o módulo. Por isso é importante consultar o suporte da sua empresa de hospedagem qual o procedimento para ativar o módulo causador da tela branca.
9. Entrar em contato com o suporte
Entre em contato com o suporte da sua hospedagem WordPress para que eles o auxiliem a resolver o erro da tela branca no WordPress. Eles até podem demorar um pouco, como é de praxe, mas eles têm conhecimentos técnicos suficientes para resolver o erro da tela branca facilmente.
Embora esse tempo de espera não seja muito bom, você pode ir tentando resolver por conta própria enquanto aguarda uma solução para o problema. Quando contratamos uma melhor hospedagem WordPress é comum que eles tentem nos ajudar a resolver o problema, mesmo que este tipo de situação seja de responsabilidade do cliente resolver.
Não custa tentar resolver dessa forma, o importante é tentar todas as possibilidades possíveis para garantir que seu site WordPress funcione corretamente o mais rápido possível.
10. Restaurar backup do site
Se você acredita que o problema começou após alguma atualização ou alteração no site, restaurar o backup pode ajudar a resolver o problema. Nesse caso você precisa ter um backup de antes do problema ocorrer.
Se foi uma simples mudança que você realizou, como uma alteração em algum arquivo, tente reverter ou remover essa alteração para corrigir o problema. Se isso não funcionar restaure o backup do site.
O procedimento para restaurar o backup vai depender do plugin de backup utilizando em seu site. Além disso, algumas hospedagem WordPress também oferecem backup automático. Nesse caso você pode acessar o painel de controle da hospedagem e procurar pela opção de backup. Depois clique em Restaurar Backup para reverter as últimas mudanças realizadas em seu site WordPress.
11. Cuidado com tutorias da internet
Existem muitos tutoriais na internet com erros, ninguém está livre deles. Inclusive aqui no WPTotal já aconteceu de postarmos algum código que poderia tirar o site do ar. Como já estamos no ar há mais de 7 anos, temos expertise para identificar possíveis problemas nos códigos antes de postamos aqui.
Inclusive vimos vários tutoriais ensinando a resolver a tela branca do WordPress com códigos incorretos tem o efeito totalmente o contrário do que se espera. Em vez de ajudar a corrigir o problema esses códigos só ajudam a tirar o site do ar.
O erro mais comum encontrado em tutoriais da internet é colocar códigos com aspas invertidas (“valor”) em vez de aspas simples (‘valor’). Quando ver um código assim não copie para seu site, mesmo que aparentemente seja de fonte confiável porque o WordPress, por padrão, realiza essa alteração nas aspas e isso pode tirar seu site do ar.
Aqui no WPTotal nós desativamos essa opção de trocar as aspas dos códigos, desse modo podemos garantir que não terá problemas ao usar os códigos postados aqui.
Conclusão
Neste tutorial você encontrou várias formas de resolver o erro tela branca do WordPress e também outros erros (esse tutorial serve para praticamente todo tipo de erro no WordPress). Seguindo os passos citados acima é possível encontrar e resolver o problema.
Como falamos anteriormente, não existe uma única causa. Portanto, não tem como dar um passo a passo simples que vai funcionar para todos os casos. É preciso analisar todas as possibilidades e executar os testes citados para resolver o problema.
Se você não conseguiu resolver o problema do seu site ou então está com dificuldade de executar algum passo do tutorial, nos informe nos comentários abaixo para que possamos ajudá-lo(a).