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 dar pistas sobre o que deu errado.

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

Por exemplo, já vimos a tela branca da morte dentro da área de administração do WordPress enquanto todo o resto funcionava bem. Em outros casos, só a vimos ao visualizar um post específico.

Entender as causas raiz desse erro é o primeiro passo para encontrar uma solução. Este guia cobrirá algumas soluções para corrigir a tela branca da morte e fornecerá etapas acionáveis 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 WordPress, isso significa que um script no seu site esgotou o limite de memória.

O script que não responde é morto pelo seu servidor de hospedagem WordPress ou simplesmente expira. É 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.

Se você está vendo uma tela em branco ou a mensagem 'Houve um erro crítico em seu site', é o mesmo erro.

Esse erro também pode ocorrer devido a um tema ou plugin mal codificado instalado em seu site. Às vezes, pode acontecer se houver um problema com seu servidor de hospedagem.

Como o erro da tela branca pode ser causado por vários motivos, ele requer solução de problemas metódica para corrigi-lo. Aqui estão as etapas que você deve tentar:

• Verifique se o problema ocorre em seus outros sites
• Corrija o erro da tela branca com o modo de recuperação do WordPress
• Aumente o limite de memória
• Corrija o erro da tela branca desativando todos os plugins
• Ative o tema padrão
• Ative o modo de depuração para capturar erros no WordPress
• Limpar o Cache do WordPress
• Corrija o erro da tela branca para artigos mais longos

Tutorial em Vídeo

Se você preferir instruções escritas, 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 estiver, isso é um forte indicador de que algo está errado com seu serviço de hospedagem WordPress. Pode ser um problema temporário afetando o serviço deles, e você precisa entrar em contato com o suporte deles para obter mais ajuda.

Por outro lado, se o problema estiver ocorrendo apenas em um site ou em uma parte específica desse site, então você sabe que o problema é com esse site em particular.

2. Corrija o Erro da Tela Branca com o Modo de Recuperação do WordPress

Se o erro da tela branca da morte for causado por um plugin ou tema do WordPress, o WordPress poderá detectá-lo.

O novo recurso de proteção contra erros fatais introduzido no WordPress 5.2 às vezes pode detectar o erro, então você pode nem ver uma tela branca. Em vez disso, você verá uma mensagem de que o site está com dificuldades técnicas.

O WordPress também enviará um e-mail sobre o problema para o seu endereço de e-mail de administrador.

O e-mail terá o assunto 'Seu site está enfrentando um problema técnico'.

Esta mensagem de e-mail indicará o plugin ou tema que está causando o erro e também conterá um link especial.

Este link permitirá que você acesse o modo de recuperação do WordPress e desative o plugin com defeito.

No entanto, se você estiver vendo a tela branca da morte sem e-mail ou opção de modo de recuperação, precisará corrigir o erro manualmente.

3. Aumente o Limite de Memória

Geralmente, esse erro ocorre porque um script esgotou a memória do seu servidor web e parou no meio.

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 a tarefa que deveria fazer.

Você precisará editar o arquivo wp-config.php em seu site WordPress ou usar um plugin 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 Plugins

Se aumentar o limite de memória PHP não ajudou, ou se você tem um limite de memória alto, como 256M ou 512M, então você precisa começar a solucionar o problema.

Em nossa experiência na solução desse problema, sempre descobrimos que o problema está em um plugin ou tema específico. Vamos desativar todos os plugins.

Se você ainda puder acessar o painel de administração do WordPress, poderá simplesmente ir para a página Plugins » Plugins Instalados. Selecione todos os plugins instalados e, em seguida, selecione 'Desativar' no menu suspenso 'Ações em massa'.

No entanto, se você não tiver acesso à área de administração do WordPress, precisará desativar todos os plugins via FTP.

Primeiro, conecte-se ao seu site WordPress usando um cliente FTP ou o gerenciador de arquivos do seu provedor de hospedagem. Uma vez conectado, vá para a pasta wp-content, onde você verá a pasta plugins.

Agora, você precisa clicar com o botão direito na pasta plugins e selecionar ‘Renomear’. Você pode renomear a pasta plugins para ‘plugins-desativados’.

O WordPress procura por uma pasta chamada plugins para carregar todos os plugins. Quando ele não encontra a pasta, ele simplesmente desativa todos os plugins.

Se isso resolver o problema, ative um plugin por vez para chegar à raiz do problema. Assim que encontrar o plugin que está causando o problema, você pode substituí-lo por uma alternativa ou relatar o problema aos autores do plugin.

5. Ative o Tema Padrão

Se a solução de problemas de plugins não resolver o problema, você deve tentar substituir seu 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 no seu site.

Clique com o botão direito para selecionar seu tema WordPress atual e baixe-o para o seu computador como backup.

Em seguida, você precisa excluir seu tema atual do seu site.

Simplesmente clique com o botão direito na pasta do seu tema e selecione ‘Excluir’. Seu cliente FTP agora 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 no 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 FTP.

Se isso resolver o problema, então você deve verificar o arquivo functions.php do seu tema. Se houver espaços extras no final 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 pode causar o erro de tela branca da morte.

Considere baixar uma cópia nova do seu tema de sua origem e, em seguida, instalá-la manualmente usando FTP.

6. Habilite o Modo de Depuração para Capturar Erros no WordPress

Se nada ajudou até agora, o próximo passo é ativar a depuração no WordPress. Isso manterá logs de erros que permitirão que você veja que tipo de erros estão sendo gerados.

Simplesmente adicione o seguinte código ao seu arquivo wp-config.php:

define( 'WP_DEBUG', true);
define( 'WP_DEBUG_LOG', true );

Assim que adicionar isso, a tela em branco agora exibirá erros, avisos e notificações. Estes podem ajudar a determinar a causa raiz.

Se você não vir nenhum erro, talvez ainda queira verificar o log de depuração.

Simplesmente acesse a pasta wp-content em seu site usando um cliente FTP. Lá, você encontrará um novo arquivo debug.log contendo um registro de todos os erros, notificações e avisos.

7. Limpe o Cache do WordPress

Às vezes, você pode ter acesso ao backend, mas o front-end do site exibe a tela branca da morte.

Isso pode acontecer por causa de um plugin de cache. Nesse caso, você simplesmente precisa esvaziar o cache do seu WordPress.

Você pode ver nosso guia sobre como limpar o cache no WordPress para instruções detalhadas.

8. Corrija o Erro da Tela Branca para Artigos Mais Longos

Se você tiver uma tela branca da morte apenas em uma postagem ou página muito longa, este método pode funcionar.

Este truque basicamente aumenta a capacidade de processamento de texto do PHP, aumentando o limite de recursão e backtrack. Você pode colar o seguinte código no seu arquivo wp-config.php:

/** Trick for long posts */
ini_set('pcre.recursion_limit',20000000);
ini_set('pcre.backtrack_limit',10000000);

Entendemos que este é um erro muito frustrante e esperamos que um dos truques acima tenha corrigido o problema para você.

Você também pode querer ver nosso guia de solução de problemas do WordPress, que ensina os passos que você deve tomar para capturar e corrigir problemas do WordPress por conta própria, ou nossa lista dos problemas mais comuns do editor de blocos do WordPress e como resolvê-los.

Se você gostou deste artigo, por favor, inscreva-se em nosso Canal do YouTube para tutoriais em vídeo do WordPress. Você também pode nos encontrar no Twitter e no Facebook.