Como corrigir a tela branca da morte do WordPress

postado em por martinho

A tela branca da morte (WSOD) do WordPress é um erro comum que resulta em uma tela em branco, dificultando a compreensão da causa, pois não há mensagens de erro exibidas. Ele pode ser causado por conflitos de plugins ou temas, limites de memória PHP esgotados ou problemas com o núcleo do WordPress. Aqui está um guia passo a passo para solucionar problemas e corrigir o WSOD:

Ativar depuração

A ativação do modo de depuração do WordPress pode ajudá-lo a descobrir mensagens de erro específicas. Para fazer isso:

  • Acesse seu site via FTP ou pelo gerenciador de arquivos do seu host e localize o arquivo wp-config.php arquivo.
  • Edite o arquivo e procure a linha que diz define('WP_DEBUG', falso);. Mudança falso para verdadeiro. Se a linha não existir, adicione-a acima da linha "That's all, stop editing! Feliz publicação":
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Essa configuração registrará os erros em um arquivo chamado debug.log dentro do wp-content sem exibi-los aos visitantes do seu site.

Desativar todos os plug-ins

Os plug-ins geralmente são os culpados pela WSOD. Para verificar se um plug-in está causando o problema:

  • Use o FTP ou o gerenciador de arquivos do seu host para navegar até o arquivo wp-content pasta.
  • Renomear o plugins para algo como plugins_old. Isso desativa todos os plug-ins.
  • Verifique seu site novamente. Se ele estiver funcionando novamente, um dos plug-ins está causando o problema. Renomeie a pasta de volta para plugins e, em seguida, desative cada plug-in, um a um, no painel do WordPress, para isolar o plug-in problemático.

    Aumentar o limite de memória do PHP

    A memória insuficiente alocada para o PHP também pode levar ao WSOD:

    • No wp-config.php adicione a seguinte linha:
    define('WP_MEMORY_LIMIT', '256M');

    Isso aumenta o limite de memória do PHP para 256 MB. Se ainda encontrar o WSOD depois disso, o problema pode estar relacionado ao limite geral de memória do seu ambiente de hospedagem, e talvez seja necessário entrar em contato com o provedor de hospedagem.

    Verificação de erros de sintaxe

    Se você editou algum arquivo recentemente, a causa pode ser um erro de sintaxe:

    • Revise as alterações que você fez. Se não tiver certeza, reverta para uma versão anterior do arquivo.
    • Use um verificador de sintaxe PHP ou um editor com realce de sintaxe para detectar e corrigir erros.

    Limpar o cache

    Às vezes, seu navegador ou plugins de cache podem mostrar uma versão em cache do WSOD:

    • Limpe o cache do navegador e, se possível, limpe o cache por meio do painel de controle de hospedagem ou das configurações do plug-in de cache.

    Verificar permissões de arquivos

    Permissões de arquivo incorretas também podem causar a WSOD:

    • Os arquivos devem ser definidos como 644 ou 640 e os diretórios como 755 ou 750. Você pode verificar e alterar as permissões usando um cliente FTP.

    Restaurar a partir de um backup

    Se nenhuma das etapas acima funcionar, a restauração do site a partir de um backup pode ser uma solução rápida para que o site volte a funcionar:

    • Use um backup recente para restaurar os arquivos e o banco de dados do WordPress.

    Entre em contato com o provedor de hospedagem

    Se você ainda estiver preso, seu provedor de hospedagem poderá oferecer insights sobre erros de servidor, problemas de banco de dados ou outros problemas relacionados à hospedagem que possam estar causando o WSOD.

    Seguindo metodicamente essas etapas, você poderá diagnosticar e corrigir a causa da Tela Branca da Morte do WordPress. Lembre-se de que fazer backups regulares e testar as alterações em um ambiente de teste pode ajudar a evitar que os problemas afetem seu site ativo.