A tela branca da morte do WordPress é um dos erros mais comuns do WordPress. Também é um erro frustrante porque não há mensagem e você fica bloqueado no WordPress.
Outro problema com o erro da tela branca da morte é que, às vezes, ele afeta apenas uma determinada parte do seu site. Por exemplo, talvez você só veja a tela branca da morte dentro da área de administração do WordPress, enquanto todo o resto funciona bem. Em outros casos, pode ser que ela apareça somente em um post específico.
Neste artigo, mostraremos como corrigir a tela branca da morte do WordPress, analisando diferentes soluções.
Observação: antes de fazer qualquer alteração em seu site, certifique-se de ter um backup do site do WordPress. Se você não tiver acesso à área de administração, consulte nosso guia sobre como criar manualmente um backup do banco de dados do WordPress.
Por que você vê a tela branca da morte no WordPress?
Na maioria das vezes, quando você vê uma tela branca da morte ao tentar visitar seu site do WordPress, isso significa que um script em seu site esgotou o limite de memória.
O script que não responde é eliminado pelo servidor de hospedagem do WordPress ou simplesmente atinge o tempo limite. É por isso que nenhuma mensagem de erro real é gerada, e você vê apenas uma tela branca em branco.
No entanto, às vezes, você pode ver uma mensagem de erro.
Por exemplo, você pode ver uma mensagem de erro crítico em vez de uma página em branco.
Não importa se você está vendo uma tela em branco ou a mensagem “Houve um erro crítico no seu site”, o erro é o mesmo.
Esse erro também pode ocorrer devido a um tema ou plug-in mal codificado instalado em seu site. Às vezes, isso pode ocorrer se houver um problema com seu servidor de hospedagem na Web.
Como o erro de tela branca pode ser causado por vários fatores, é necessária uma solução de problemas metódica para corrigi-lo. Aqui estão as etapas que você deve tentar:
- Check Whether the Problem Happens on Your Other Sites
- Fix the White Screen Error With WordPress Recovery Mode
- Increase the Memory Limit
- Fix the White Screen Error by Disabling All Plugins
- Activate the Default Theme
- Enable Debug Mode to Catch Errors in WordPress
- Clear the WordPress Cache
- Fix the White Screen Error for Longer Articles
Tutorial em vídeo
Se você preferir instruções por escrito, continue lendo.
1. Verifique se o problema ocorre em seus outros sites
Se você tiver outros sites WordPress instalados na mesma conta de hospedagem, comece verificando se o problema também está ocorrendo em outros sites.
Se for, esse é um forte indicador de que há algo errado com seu serviço de hospedagem WordPress. Esse pode ser um problema temporário que afeta o serviço e você precisa entrar em contato com o suporte para obter mais ajuda.
Por outro lado, se o problema estiver ocorrendo somente em um site ou em uma parte específica desse site, você saberá que o problema está nesse site específico.
2. Corrigir o erro de tela branca com o modo de recuperação do WordPress
Se o erro da tela branca da morte for causado por um plug-in ou tema do WordPress, o WordPress poderá detectá-lo.
O novo recurso de proteção contra erros fatais introduzido no WordPress 5.2 pode, às vezes, detectar o erro, de modo que talvez você nem veja uma tela branca. Em vez disso, você verá uma mensagem informando que o site está com dificuldades técnicas.
O WordPress também enviará um e-mail sobre o problema para seu endereço de e-mail de administrador.
O e-mail terá o assunto “Seu site está passando por um problema técnico”.
Essa mensagem de e-mail indicará o plug-in ou o tema que está causando o erro e também conterá um link especial.
Esse link permitirá que você faça login no modo de recuperação do WordPress e desative o plug-in com defeito.
No entanto, se estiver vendo a tela branca da morte sem nenhuma opção de e-mail ou modo de recuperação, será necessário corrigir o erro manualmente.
3. Aumentar o limite de memória
Normalmente, esse erro ocorre porque um script esgotou a memória do servidor da Web e foi encerrado no meio do processo.
Para corrigir isso, você precisa aumentar a memória PHP disponível para o WordPress. Isso permitirá que o script use mais memória para concluir o trabalho que deveria fazer.
Você precisará editar o arquivo wp-config.php em seu site do WordPress ou usar um plug-in de snippet de código como o WPCode.
Você pode seguir as instruções em nosso tutorial sobre como aumentar a memória PHP no WordPress.
4. Corrija o erro de tela branca desativando todos os plug-ins
Se o aumento do limite de memória do PHP não ajudar, ou se você tiver um limite de memória alto, como 256M ou 512M, será necessário iniciar a solução de problemas.
Em nossa experiência de solução de problemas, sempre descobrimos que o problema está em um plug-in específico ou em um tema. Vamos em frente e desativar todos os plug-ins.
Se ainda puder acessar o painel de administração do WordPress, basta ir para a página Plugins ” Plugins instalados. Selecione todos os plug-ins instalados e, em seguida, selecione “Deactivate” (Desativar) no menu suspenso “Bulk actions” (Ações em massa).
No entanto, se você não tiver acesso à área de administração do WordPress, precisará desativar todos os plug-ins via FTP.
Primeiro, conecte-se ao seu site WordPress usando um cliente FTP ou o gerenciador de arquivos do seu provedor de hospedagem. Depois de conectado, vá para a pasta wp-content, onde você verá a pasta plugins.
Agora, você precisa clicar com o botão direito do mouse na pasta de plug-ins e selecionar “Renomear”. Você pode renomear a pasta de plug-ins para “plugins-deactivated”.
O WordPress procura uma pasta chamada plugins para carregar todos os plugins. Quando não consegue encontrar a pasta, ele simplesmente desativa todos os plug-ins.
Se isso corrigir o problema, ative um plug-in de cada vez para descobrir a causa do problema. Quando encontrar o plug-in que está causando o problema, você poderá substituí-lo por um alternativo ou relatar o problema aos autores do plug-in.
5. Ativar o tema padrão
Se a solução de problemas do plug-in não resolver o problema, tente substituir o tema ativo por um tema padrão.
Primeiro, conecte-se ao seu site usando um cliente FTP e vá para a pasta /wp-content/themes/. Ela contém todos os temas instalados em seu site.
Clique com o botão direito do mouse para selecionar o tema atual do WordPress e baixá-lo para o computador como um backup.
Em seguida, você precisa excluir o tema atual do seu site.
Basta clicar com o botão direito do mouse na pasta do tema e selecionar “Excluir”. Seu cliente FTP excluirá o tema do seu site.
Agora, se você tiver um tema padrão do WordPress como (Twenty Twenty-Two ou Twenty Twenty-Three) instalado em seu site, o WordPress começará a usá-lo automaticamente como tema padrão.
No entanto, se você não tiver um tema padrão instalado, precisará instalá-lo manualmente usando o FTP.
Se isso corrigir o problema, você deverá examinar o arquivo functions.php do tema. Se houver espaços extras na parte inferior do arquivo, você precisará removê-los e, às vezes, isso resolve o problema.
Se você estiver usando uma função mal codificada no arquivo functions.php do seu tema, isso também poderá causar o erro de tela branca da morte.
Considere a possibilidade de baixar uma nova cópia do tema a partir da fonte e instalá-la manualmente usando FTP.
6. Ativar o modo de depuração para detectar erros no WordPress
Se nada tiver ajudado até agora, a próxima etapa é ativar a depuração no WordPress. Isso manterá registros de erros que lhe permitirão ver que tipo de erros estão sendo emitidos.
Basta adicionar o seguinte código ao seu arquivowp-config.php:
define( 'WP_DEBUG', true);
define( 'WP_DEBUG_LOG', true );
Depois de adicionar isso, a tela em branco passará a ter erros, avisos e notificações. Eles podem ajudá-lo a determinar a causa raiz.
Se não houver nenhum erro, talvez seja melhor verificar o registro de depuração.
Basta acessar a pasta wp-content em seu site usando um cliente FTP. Lá, você encontrará um novo arquivo debug.log que contém um registro de todos os erros, avisos e advertências.
7. Limpar o cache do WordPress
Às vezes, você pode ter acesso ao back-end, mas o front-end do site apresenta a tela branca da morte.
Isso pode acontecer por causa de um plugin de cache. Nesse caso, basta esvaziar o cache do WordPress.
Consulte nosso guia sobre como limpar o cache no WordPress para obter instruções detalhadas.
8. Corrigir o erro de tela branca para artigos mais longos
Se você tiver uma tela branca da morte somente em uma postagem ou página muito longa, esse método poderá funcionar.
Esse truque basicamente aumenta a capacidade de processamento de texto do PHP, aumentando o limite de recursão e retrocesso. Você pode colar o código a seguir em seu arquivo wp-config.php:
/** Trick for long posts */
ini_set('pcre.recursion_limit',20000000);
ini_set('pcre.backtrack_limit',10000000);
Entendemos que esse é um erro muito frustrante e esperamos que um dos truques acima tenha corrigido o problema para você.
Talvez você também queira ver nosso guia de solução de problemas do WordPress, que ensina as etapas que você deve seguir para detectar e corrigir problemas do WordPress por conta própria, ou nossa seleção de especialistas dos melhores provedores de hospedagem gerenciada do WordPress.
Se você gostou deste artigo, inscreva-se em nosso canal do YouTube para receber tutoriais em vídeo sobre o WordPress. Você também pode nos encontrar no Twitter e no Facebook.
Syed Balkhi says
Hey WPBeginner readers,
Did you know you can win exciting prizes by commenting on WPBeginner?
Every month, our top blog commenters will win HUGE rewards, including premium WordPress plugin licenses and cash prizes.
You can get more details about the contest from here.
Start sharing your thoughts below to stand a chance to win!
Robert Thompson says
My entire WordPress site is a black screen. I only have three pages on my website and they all are black. But when I go to my editor everything is fine. I’m going to try your advice and deactivate all of my plugins. Hopefully this will work.
WPBeginner Support says
We hope that solves the issue for you, if you continue to have trouble you can always feel free to reach out to our support!
Administrador
mohadese esmaeeli says
I have encountered this page several times, and in most cases, my issue was resolved by changing the PHP version of the hosting. However, sometimes the presence of an incompatible plugin can disrupt everything and result in this frustrating white screen!
WPBeginner Support says
Thank you for sharing what worked for you
Administrador
Jiří Vaněk says
Very often, the issue with a white screen is a compromised website. Many people have their WordPress sites infected, leading to precisely this error. That’s why it’s crucial to have a backup. Additionally, many people suffer from downloading plugins from unverified sources to save money. In the end, it costs more than a paid plugin. Unfortunately, it’s true. Sad, but true.
WPBeginner Support says
While it could be a compromised site, there are many possible reasons so only having a white screen of death does not automatically mean that a site was hacked.
Administrador
Ralph says
Does this method helps with my situation?
Sometimes I update few plugins one by one on 1 side of the screen and do something else on second half. It happens i refresh wordpress admin panel during updating plugin and it gives me this white page where I can’t do anything. My hosting makes backups every 6 hours so i just email them to use the freshest one but I want to move to the cheaper one and will not have this option.
WPBeginner Support says
It should be helpful when you run into the white screen, from the sound of it you would want to reach out to your hosting provider to see if you are hitting a resource or memory limit in their system.
Administrador
Ralph says
I did not think about memory limit, thank you for letting me know. I will contact them to confirm this.
CJB says
The memory limit increase fixed it for me. (This issue rarely happens in WordPress, but the client’s hosting company is a smaller brand that may have contributed to the error.)
WPBeginner Support says
Glad to hear you could resolve the issue!
Administrador
hank says
I get the white screen of death when i log in, i don’t get it when logged out though
WPBeginner Support says
You may be seeing the cached page when logged out. If you do see the white screen of death, we would recommend going through the troubleshooting steps in this guide.
Administrador