Como corrigir a tela branca da morte do WordPress (passo a passo)

A tela branca da morte pode ser o pior pesadelo de um proprietário de site. Esse erro frustrante do WordPress deixa você olhando para uma página em branco, sem oferecer nenhuma pista sobre o que deu errado.

Para piorar a situação, esse erro comum do WordPress às vezes pode afetar partes específicas do seu site, como a área de administração ou postagens individuais.

Por exemplo, vimos a tela branca da morte dentro da área de administração do WordPress enquanto todo o resto estava funcionando bem. Em outros casos, só a vimos ao visualizar uma postagem específica.

Entender as causas básicas desse erro é a primeira etapa para encontrar uma solução. Este guia abordará algumas soluções para corrigir a tela branca da morte e fornecerá etapas práticas para restaurar a funcionalidade do seu site.

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:

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 lista dos problemas mais comuns do editor de blocos do WordPress e como corrigi-los.

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.