Como corrigir a tela branca da morte do WordPress

Publicados: 2022-06-20

Ao tentar acessar seu site WordPress, você pode ver de repente uma página de erro em branco. Essa tela branca da morte (WSOD) pode ser incrivelmente frustrante porque torna seu site inacessível, incluindo o back-end.

Felizmente, geralmente é muito fácil solucionar qualquer conflito que possa estar causando o problema. Neste post, vamos explicar o que é o WSOD e como ele pode acontecer. Em seguida, mostraremos oito maneiras diferentes de corrigir esse problema no WordPress.

Uma introdução à tela branca da morte no WordPress

Como o próprio nome sugere, a tela branca da morte (WSOD) é um erro comum do WordPress que se manifesta como uma tela branca em branco. Isso pode ser alarmante, pois normalmente não exibe uma mensagem de erro explicando o que está errado.

O WSOD pode parecer diferente dependendo do navegador da Web que você está usando. No Google Chrome, por exemplo, você pode ver uma mensagem de erro HTTP 500. Mas a maioria dos navegadores não mostra nenhuma informação.

A Tela Branca da Morte pode causar tempo de inatividade do site, impedindo que os visitantes acessem seu conteúdo. Também é possível que você veja esse erro apenas em páginas específicas, e não em todo o site.

Esse problema também pode acontecer no back-end, bloqueando você do painel do WordPress. Nesse caso, seu conteúdo estará ao vivo, mas você não poderá realizar nenhuma atualização ou manutenção.

Causas potenciais da tela branca da morte do WordPress

Embora você possa assumir imediatamente que seu servidor está inativo ou que alguém invadiu seu site, a Tela Branca da Morte geralmente não está relacionada a esses problemas. Quando você vê uma página de erro em branco, provavelmente é devido a erros de PHP ou banco de dados.

Infelizmente, não há uma solução única para o WSOD, pois muitas coisas diferentes podem causar isso. Mas a causa mais comum é o esgotamento dos limites de memória. Isso significa que os scripts PHP em seu site estão sobrecarregando a memória do seu servidor.

Você também pode ver o WSOD devido a conflitos de tema ou plugin. Portanto, se você acabou de atualizar seus plugins ou instalou um novo, provavelmente esse é o problema. É por isso que é importante testar novas atualizações de software em um site de teste antes de instalá-las em seu site ativo.

lista de plugins instalados em um site WordPress

O WSOD também pode ser o resultado de permissões de arquivo estritas. Como as configurações de permissão de arquivo afetam como os usuários no nível do servidor lidam com seus arquivos, elas podem acionar erros como a Tela Branca da Morte.

Além disso, se apenas o front-end do seu site estiver inativo, pode ser devido a problemas de cache. Portanto, corrigir o WSOD pode ser tão simples quanto limpar seu cache.

Como corrigir a tela branca da morte do WordPress

Antes de começar, é importante fazer backup do seu conteúdo. Isso porque quando você edita os arquivos principais do WordPress, corre o risco de quebrar seu site.

Se você puder acessar seu painel, basta instalar um plug-in de backup como o Jetpack Backup para salvar seus dados com rapidez e segurança. Você poderá restaurar esses arquivos se algo der errado.

Como alternativa, como o WSOD pode bloqueá-lo da área de administração, talvez seja necessário fazer backup manual do seu site. Você pode fazer isso usando um cliente FTP. Quando terminar, é hora de solucionar o problema da Tela Branca da Morte!

1. Limpe o cache do seu navegador

O cache do seu navegador armazena versões do seu site para que ele possa consultá-lo rapidamente e carregá-lo novamente no futuro. Mas se ficar desatualizado, isso também pode resultar em um WSOD.

Este é bem simples de resolver. Tudo o que você precisa fazer é limpar o cache do seu navegador. Isso garante que você esteja vendo a versão mais recente do seu site.

Para fazer isso, navegue até as configurações do seu navegador. No Google Chrome, você precisará clicar nos três pontos no canto superior direito e selecionar Mais ferramentas → Limpar dados de navegação :

limpando o cache do navegador no Google Chrome

Isso o levará a uma página onde você pode limpar seu histórico de navegação, cookies e outros dados do site. Você também pode optar por excluir imagens e arquivos armazenados em cache.

opções para limpar o cache do navegador no Chrome

Se você também tiver um plug-in de cache do WordPress instalado, considere limpar seu cache também. Embora as etapas variem dependendo do seu plug-in, você precisará encontrar suas configurações e “limpar” o cache.

Como exemplo, você pode limpar o cache no plugin LiteSpeed ​​Cache clicando em seu ícone na parte superior da página. Em seguida, selecione Limpar tudo .

limpando seu cache com o LiteSpeed ​​Cache

Se você tiver um plano de hospedagem que permita o armazenamento em cache, poderá limpar o cache usando o painel de controle. Essa pode ser uma opção eficaz, especialmente se você não conseguir acessar seu painel de administração.

2. Desative todos os plugins ativos

A Tela Branca da Morte pode ser o resultado de conflitos de plugins. Para resolver esse problema, você deve desabilitar todos os plugins ativos e reativá-los um por um. Este processo irá ajudá-lo a identificar o plugin que está causando o erro.

Se você puder acessar seu painel, basta acessar a página Plugins e selecionar todos os plug-ins ativos usando o recurso Ações em massa . Em seguida, selecione Desativar , seguido de Aplicar .

desativando plugins em massa

Em seguida, verifique se isso resolveu o WSOD. Nesse caso, reative cada plug-in, um de cada vez. Após cada ativação, verifique se o problema voltou. Isso permitirá que você corresponda o erro a um plug-in específico.

Depois de encontrar o plug-in com problema, você pode excluí-lo e baixar uma ferramenta diferente com funcionalidade semelhante. Se você quiser manter o plug-in, considere revertê-lo para uma versão anterior. Usando uma ferramenta como WP Rollback, você pode retornar plugins para iterações mais antigas.

Se a Tela Branca da Morte impedir você de fazer login no seu painel, você terá que adotar uma abordagem diferente. Quando isso acontecer, você precisará desabilitar os plugins usando um gerenciador de arquivos ou cliente de protocolo de transferência de arquivos (FTP).

Com o cPanel, você pode acessar e editar os arquivos do seu site usando as informações de login do seu provedor de hospedagem. Em seguida, localize a pasta wp-content dentro da pasta public_html .

abrindo a pasta wp-content no cpanel

Em seguida, localize a pasta de plugins. Renomeie-o como “ plugins desativados ”:

renomeando a pasta de plugins no cpanel

Em seguida, tente fazer login no seu painel do WordPress. Se desabilitar os plugins resolver o WSOD, você precisará reativá-los um por um para direcionar a origem do problema.

3. Substitua seu tema

Seu tema ativo também pode ser incompatível com um ou mais plugins devido a softwares conflitantes. Para ver se isso está causando o WSOD, considere substituir seu tema atual por um tema padrão.

Para fazer isso, vá ao seu painel e selecione Aparência → Temas . Em seguida, procure um tema padrão do WordPress.

lista de temas instalados no WordPress

Depois de encontrar um tema padrão, instale-o e ative-o. Depois disso, recarregue seu site para ver se isso resolveu o WSOD.

Se a Tela Branca da Morte bloquear você da área de administração, você não poderá passar por esse processo. Como alternativa, você pode instalar um tema padrão usando o cPanel ou um cliente FTP.

Desativar seu tema é muito semelhante a desativar plugins. Em seu arquivo wp-content , localize o arquivo Themes . Renomeie-o como "desativado por temas":

renomeando a pasta de temas no cpanel

Isso deve reverter automaticamente seu tema para a versão padrão mais recente que você instalou em seu site.

Se você não tiver nenhum tema padrão instalado, precisará instalar um manualmente. Comece encontrando um tema padrão no diretório de temas do WordPress. Em seguida, baixe-o como um arquivo .zip .

No cPanel ou em um cliente FTP, carregue este arquivo .zip para a pasta Themes .

Ao usar o cPanel, extraia o arquivo .zip na mesma pasta. Para um cliente FTP, você pode pular esta etapa.

carregando um tema via cpanel

Se você usa o cPanel ou um cliente FTP, a última etapa é ativar o tema padrão. Para fazer isso, faça login no painel do WordPress e navegue até Temas . Em seguida, ative a opção padrão que você acabou de instalar.

4. Ative o modo de depuração

Mesmo depois de tentar as soluções anteriores, você ainda poderá ver a tela branca da morte no seu site WordPress. Como esse erro não exibirá uma causa, convém ativar o modo de depuração para identificar o problema específico.

Para ativar o modo de depuração, você precisará editar o arquivo wp-config.php do seu site. Como isso lida com os detalhes da configuração básica do seu site, é importante fazer backup do conteúdo do seu site antes de começar.

Depois de criar seu backup, abra um gerenciador de arquivos como o cPanel ou um cliente FTP. Em seguida, localize o arquivo wp-config.php , que estará na pasta public_html .

Se você já usou o modo de depuração antes, encontre esta linha de código:

 define( 'WP_DEBUG', false );

Em seguida, basta alterar “falso” para “verdadeiro”.

editando o arquivo wp-config.php

Se você ainda não vir esta linha de texto, copie e cole este código no arquivo wp-config.php :

 // Enable WP_DEBUG mode define( 'WP_DEBUG', true ); // Enable Debug logging to the /wp-content/debug.log file define( 'WP_DEBUG_LOG', true );

Quando você reabrir a página da Web com o WSOD, ela agora deve exibir novas mensagens de erro e aviso. Isso lhe dará mais informações sobre por que o WSOD aconteceu e de qual arquivo ele se originou.

5. Ajuste o limite de memória do seu servidor

Uma das razões mais comuns para a Tela Branca da Morte é o esgotamento do limite de memória. Isso acontece quando seus scripts PHP estão drenando a memória máxima alocada do seu host. Para resolver esse problema, você precisará aumentar o limite de memória.

Semelhante ao modo de depuração, os limites de memória podem ser ajustados usando o arquivo wp-config.php do seu site. Você pode acessar este arquivo entrando no cPanel com seu provedor de hospedagem.

Após acessar o cPanel, vá para public_html → wp-config.php . Nesse arquivo, encontre a linha que diz “Isso é tudo, pare de editar! Boa publicação.” Adicione esta linha de código logo antes dela:

 define( 'WP_MEMORY_LIMIT', '64M' );

Isso aumentará seu limite de memória PHP do WordPress para 64 MB. Quando terminar, salve suas alterações.

Em seguida, volte ao seu site e veja se o WSOD desapareceu. Caso contrário, você pode repetir o processo para aumentar ainda mais o limite de memória. Lembre-se de que a maioria dos provedores de hospedagem terá um limite máximo de memória, especialmente se você estiver em um plano compartilhado.

Se isso não adicionar memória suficiente, talvez seja necessário contratar um desenvolvedor para procurar os plug-ins que estão usando muitos recursos. Como alternativa, seu provedor de hospedagem pode fornecer logs de recursos e SQL para seu site, que você pode usar para identificar a área que está esgotando seu limite de memória.

6. Restaurar um backup

Uma das causas mais comuns do WSOD é simplesmente o erro do usuário. Mesmo desenvolvedores experientes podem cometer erros ao editar o código. E um simples erro de digitação pode levar a problemas sérios.

Se você não conseguir encontrar a linha de código defeituosa, poderá restaurar uma versão anterior do seu site. Isso pode ser muito mais fácil do que tentar solucionar a causa.

Jetpack Backup é uma ferramenta poderosa que salva tudo o que você faz em seu site em tempo real. Portanto, se você encontrar um WSOD, basta reverter o site para uma versão anterior.

Quando precisar restaurar um backup, faça login na sua conta do WordPress.com e navegue até Jetpack → Backup.

Basta encontrar aquele que você deseja restaurar e clicar em Restaurar até este ponto . Isso pode desfazer quaisquer alterações recentes que você fez durante a codificação.

7. Resolva falhas de atualização automática

Às vezes, o WordPress pode falhar ao concluir as atualizações, especialmente se o servidor expirar. Normalmente, isso se resolve sozinho, mas ocasionalmente pode causar a Tela Branca da Morte.

Quando seu site usa atualizações automáticas, o WordPress colocará seu site no 'modo de manutenção' durante o processo de atualização. Ocasionalmente, seu site pode ficar travado no modo de manutenção. Se houver um problema de compatibilidade, você precisará corrigi-lo manualmente.

Para fazer isso, primeiro, vá para o seu diretório raiz. Você pode usar a conta cPanel do seu provedor de hospedagem ou acessar os arquivos do seu site por meio de um cliente FTP.

Abra a pasta public_html . Na lista de opções, verifique se há um arquivo .maintenance .

encontrando o arquivo .maintenance no cpanel

O WordPress geralmente carrega esse arquivo durante as atualizações e o exclui quando elas terminam. Se você vir um arquivo .maintenance , selecione-o e exclua-o.

Em seguida, recarregue seu site. Se o upload foi concluído com êxito antes do erro, seu site deve estar funcionando novamente.

8. Verifique suas permissões de arquivo do WordPress

Embora suas permissões de arquivo possam estar causando a tela branca da morte do WordPress, é melhor tentar essa correção como último recurso. Sem a experiência certa, você pode acidentalmente criar vulnerabilidades que levam a hacks.

Ainda assim, alterar suas permissões de arquivo pode ser útil quando tudo mais falhar. Para começar, vá para o seu Gerenciador de Arquivos. Em seguida, abra a pasta public_html e selecione as pastas wp-admin , wp-content e wp-includes .

Clique com o botão direito do mouse em sua seleção e encontre Permissões . Isso abrirá as informações de permissões de arquivo para o seu site.

encontrando permissões de arquivo no cpanel

Aqui estão algumas coisas básicas a serem lembradas ao alterar as permissões de arquivo:

  • As pastas devem ter um valor de 775 ou 755.
  • Os arquivos devem ter um valor de 664 ou 644.
  • O arquivo wp-config.php deve ter um valor de 660, 600 ou 644.

Para os arquivos selecionados, defina seu valor numérico para 755. Em seguida, certifique-se de que o botão Recursivo esteja marcado.

editando permissões de arquivo no cpanel

Após atualizar as permissões para esses arquivos, continue selecionando todos os arquivos em seu diretório raiz. Em seguida, clique com o botão direito do mouse novamente para visualizar as permissões do arquivo.

Desta vez, certifique-se de que o valor numérico esteja definido como 644. Depois de atualizar as permissões do arquivo, verifique se o WSOD desapareceu.

Como evitar a tela branca da morte no futuro

Corrigir a tela branca da morte no WordPress pode envolver uma extensa solução de problemas, por isso é importante saber como evitar que esse erro aconteça novamente. Felizmente, existem algumas medidas preventivas que você pode tomar.

Algumas razões comuns para o WSOD são conflitos de temas e plugins. Para evitar a criação de problemas em seu site, certifique-se de instalar apenas softwares confiáveis. Isso envolve pesquisar temas e plugins antes da instalação.

Para garantir que um tema ou plugin específico seja seguro, você pode verificar o número de instalações ativas. Provavelmente, quanto maior o número de instalação, melhor será o plugin. Você também pode ler comentários de usuários para ver o que outros proprietários e desenvolvedores de sites têm a dizer.

Você também deve certificar-se de que o plugin ou tema foi atualizado recentemente. Geralmente, é melhor não instalar software que não tenha sido atualizado nos últimos seis meses.

Depois de encontrar o plugin ou tema certo, você pode usar um site de teste para testá-lo. Isso envolve fazer uma cópia do seu site ao vivo para executar testes de desempenho com segurança em um novo software. Ao fazer isso, você pode verificar quaisquer problemas de compatibilidade antes de iniciar os aplicativos em seu site ao vivo.

Finalmente, é aconselhável limitar o número de plugins ativos em seu site. Quando você tem muitos plugins, aumenta o risco de incompatibilidade de software. Portanto, considere ativar apenas os plugins que você usa regularmente.

Uma solução para erros comuns do WordPress

É natural se preocupar quando você está bloqueado no seu site e só consegue ver uma página de erro em branco. Felizmente, embora o WSOD pareça assustador, geralmente você pode remediá-lo solucionando as causas mais comuns.

Se você dedicou muito trabalho ao seu site ou é uma parte importante do seu sustento, é melhor investir em ferramentas de segurança do WordPress, como Jetpack e Jetpack Backup. Com o Jetpack Backup, você pode restaurar de forma rápida e fácil as versões anteriores do seu site. Mesmo quando você experimentar a Tela Branca da Morte, seus dados estarão seguros e você poderá recuperar seu site com alguns cliques ou menos.