Resolvendo a tela branca da morte no WordPress: um guia completo
Publicados: 2024-05-16Experimentar 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:
- 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.
- 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.
- 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 arquivodebug.log
em seu diretóriowp-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:
- Navegue até
wp-content
. - Renomeie a pasta
plugins
paraplugins_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
:
- Navegue até
wp-content/themes
. - 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:
- Baixe e descompacte o WordPress.
- Faça upload das pastas
wp-admin
ewp-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:
- Atualizações regulares : mantenha o WordPress, os temas e os plug-ins atualizados com as versões mais recentes.
- Plug-ins e temas de qualidade : use plug-ins e temas confiáveis e bem codificados.
- Backups de rotina : Faça backup regularmente do seu site para garantir que você possa restaurá-lo rapidamente se surgirem problemas.
- 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.