Resolvendo a tela branca da morte no WordPress: um guia completo

Publicados: 2024-05-16

Experimentar uma “tela branca da morte no WordPress” pode ser um problema assustador para proprietários de sites. Muitas vezes referido como “Tela Branca da Morte” (WSOD), esse problema deixa seu site inacessível e em branco, causando pânico para quem não está familiarizado com a solução de problemas.

Neste guia completo, orientaremos você nas etapas para diagnosticar e corrigir a tela branca no WordPress, garantindo que seu site volte a ficar online rapidamente.

Compreendendo a tela branca da morte

A tela branca no WordPress normalmente ocorre quando um script em seu site esgota o limite de memória. No entanto, outros problemas também podem desencadear esse problema, como:

  • Conflitos de plugins ou temas
  • Limites de memória esgotados
  • Problemas do servidor
  • Arquivos principais corrompidos

Compreender essas causas potenciais ajudará você a diagnosticar e resolver melhor o problema.

Diagnosticando a tela branca no WordPress

Antes de mergulhar nas soluções, é crucial diagnosticar a causa raiz da tela branca. Aqui estão alguns passos iniciais a seguir:

  1. Verifique todas as páginas : determine se a tela branca afeta todas as páginas ou apenas seções específicas do seu site, como a área administrativa ou uma postagem específica.
  2. Desativar plug-ins e temas : desativar todos os plug-ins e mudar para um tema padrão (como Twenty Twenty-One) pode ajudar a identificar se um plug-in ou tema específico está causando o problema.
  3. Habilitar modo de depuração : o WordPress possui um recurso de depuração integrado que fornece mensagens de erro para ajudar a identificar o problema. Adicione as seguintes linhas ao seu arquivo wp-config.php :

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

    Isso registrará erros em um arquivo debug.log em seu diretório wp-content .

Consertando a tela branca no WordPress

Depois de identificar as possíveis causas, você poderá começar a solucionar problemas específicos. Aqui estão algumas etapas detalhadas para resolver a tela branca no WordPress:

1. Aumentando o limite de memória

A memória esgotada é uma causa comum da tela branca. Para aumentar o limite de memória do PHP, adicione a seguinte linha ao arquivo wp-config.php :

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

Se isso não funcionar, pode ser necessário aumentar o limite de memória no arquivo php.ini ou .htaccess do seu servidor:

  • php.ini : memory_limit = 128M
  • .htaccess : php_value memory_limit 128M

2. Desativando todos os plug-ins

Os plug-ins costumam ser os culpados por trás da tela branca. Para desativar rapidamente todos os plug-ins, renomeie o diretório plugins em sua pasta wp-content via FTP ou gerenciador de arquivos de hospedagem:

  1. Navegue até wp-content .
  2. Renomeie a pasta plugins para plugins_old .

Se isso resolver o problema, renomeie a pasta para plugins e reative cada plugin, um por um, para identificar o problemático.

3. Revertendo para um tema padrão

Um tema defeituoso também pode causar tela branca. Para mudar para um tema padrão, renomeie o diretório do seu tema ativo em wp-content/themes :

  1. Navegue até wp-content/themes .
  2. Renomeie a pasta do seu tema ativo (por exemplo, mytheme_old ).

O WordPress reverterá automaticamente para um tema padrão se estiver instalado. Se isso resolver o problema, verifique se há erros no seu tema ou considere usar um tema diferente.

4. Habilitando depuração e logs de erros

Conforme mencionado, habilitar a depuração em seu arquivo wp-config.php pode fornecer insights sobre o que está causando a tela branca. Revise o arquivo debug.log localizado no diretório wp-content para obter mensagens de erro e resolva os problemas indicados.

5. Restaurando um backup

Se você tiver backups recentes, restaurar seu site para um estado anterior pode resolver rapidamente a tela branca. Certifique-se de fazer backup regularmente do seu site para evitar perda de dados e facilitar a recuperação.

6. Verificando arquivos principais corrompidos

Arquivos principais do WordPress corrompidos também podem causar uma tela branca. Para corrigir isso, baixe uma nova cópia do WordPress em wordpress.org e substitua seus arquivos principais:

  1. Baixe e descompacte o WordPress.
  2. Faça upload das pastas wp-admin e wp-includes para o seu site via FTP, substituindo as pastas existentes.

Isso não afetará seus temas, plug-ins ou uploads, mas substituirá quaisquer arquivos principais corrompidos.

7. Correção de erros de sintaxe

Se você adicionou recentemente código personalizado ao seu tema ou plug-ins, erros de sintaxe podem causar a tela branca. Acesse seus arquivos via FTP e revise quaisquer alterações recentes em busca de erros. Use um validador PHP para verificar se há problemas de sintaxe em seu código.

Evitando a tela branca no WordPress

Prevenir a tela branca no WordPress envolve medidas proativas para garantir que seu site funcione sem problemas:

  1. Atualizações regulares : mantenha o WordPress, os temas e os plug-ins atualizados com as versões mais recentes.
  2. Plug-ins e temas de qualidade : use plug-ins e temas confiáveis ​​e bem codificados.
  3. Backups de rotina : Faça backup regularmente do seu site para garantir que você possa restaurá-lo rapidamente se surgirem problemas.
  4. Ambiente de teste : teste atualizações e novos plug-ins em um ambiente de teste antes de aplicá-los em seu site ativo.

Solução de problemas avançada

Se as etapas básicas de solução de problemas não resolverem a tela branca, considere estas técnicas avançadas:

1. Aumentando os limites de tempo do PHP

Às vezes, scripts de longa execução podem causar uma tela branca. Aumente o tempo máximo de execução adicionando esta linha ao seu arquivo wp-config.php :

 set_time_limit(300);

Alternativamente, você pode ajustar esta configuração em seu arquivo php.ini:

 max_execution_time = 300

2. Resolvendo problemas de banco de dados

Um banco de dados corrompido pode levar à tela branca. Acesse seu banco de dados via phpMyAdmin e verifique se há erros. Use o recurso “Reparar” se algum problema for encontrado.

3. Permissões de arquivo

Permissões de arquivo incorretas também podem causar tela branca. Certifique-se de que seus arquivos e diretórios do WordPress tenham as permissões corretas:

  • Arquivos: 644
  • Diretórios: 755

Erros e soluções comuns

Aqui estão alguns erros comuns associados à tela branca no WordPress e suas soluções:

1. Erro de memória esgotada

Se você vir um erro como Allowed memory size of x bytes exhausted , aumentar o limite de memória conforme descrito anteriormente resolverá o problema.

2. Erro interno do servidor 500

Um erro interno do servidor 500 geralmente acompanha a tela branca. Verifique o log de erros do seu servidor para obter detalhes e siga as etapas de solução de problemas descritas acima.

3. Erros de sintaxe

Erros de sintaxe no código personalizado podem ser identificados e resolvidos revisando as alterações recentes e usando um validador PHP.

Conclusão

A tela branca no WordPress pode ser um problema frustrante, mas com uma solução sistemática de problemas, é possível resolvê-la e restaurar seu site.

Ao compreender as causas comuns e aplicar as soluções fornecidas neste guia, você pode corrigir efetivamente a tela branca e evitar que ela se repita no futuro.

Manutenção regular, atualizações e backups são cruciais para manter seu site WordPress saudável e evitar a temida Tela Branca da Morte.