Se abres o teu site WordPress e obténs uma página branca, isso indica que o WordPress está a lançar um erro fatal, conhecido tecnicamente como erro 500 ou ecrã branco da morte.
Este erro é causado principalmente por Plugins ou Themes com mau funcionamento. Para identificares a origem do erro, podes ativar o modo debug do WordPress editando duas linhas no ficheiro wp-config.php da tua instalação WordPress.
Contents
Ativar o modo debug para resolver a página branca do WordPress
Inicia sessão em cPanel ou FTP
- Usa as tuas credenciais cPanel para iniciar sessão ou liga ao teu site através de um cliente FTP como o FileZilla.
Edita o ficheiro wp-config.php.
- No cPanel File Manager ou no teu cliente FTP, navega até à diretoria raiz do WordPress e localiza o ficheiro wp-config.php.
- Edita o ficheiro wp-config.php adicionando ou modificando as seguintes linhas:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );- Guarda as alterações ao wp-config.php.
Recarrega o teu site.
- Depois de recarregar o site, todos os erros vão ser registados no ficheiro wp-content/debug.log.
- Se preferes ver os erros diretamente no ecrã em vez de os registar, muda a linha para:
define('WP_DEBUG_DISPLAY', true);Analisa o debug.log.
- Carrega novamente o teu site WordPress. O erro específico deve ser registado no ficheiro debug.log ou apresentado no ecrã, dependendo da definição.
- Abre o ficheiro debug.log usando um Plugin de gestão de ficheiros ou FTP e procura linhas que contenham “Fatal Error…”. Estas linhas tipicamente indicam o Plugin ou Theme que causa o erro.
Desativar o Plugin que causa a página branca
- Identifica o Plugin com falha.
- Uma vez identificado o Plugin com falha a partir do debug.log, inicia sessão no teu servidor via FTP ou cPanel.
- Muda o nome da pasta do Plugin.
- Navega para a diretoria wp-content/plugins/.
- Muda o nome da pasta do Plugin problemático para outra coisa, por exemplo wp-content/plugins/yoast_bak.
- Isto vai desativar o Plugin. Recarrega o teu site e o ecrã branco deve desaparecer.
- Interpretar o log de debug.
- Se tens dificuldade em interpretar as entradas no ficheiro de log de debug, podes abrir um pedido de suporte com o teu fornecedor de Hosting ou contactar um profissional WordPress para ajuda e fornecer-lhes o ficheiro de log para análise.
- Verifica se falta o ficheiro debug.log.
- Se o ficheiro debug.log do WordPress não for criado, garante que o teu wp-config.php está corretamente editado e que o servidor tem as permissões apropriadas para escrever na diretoria wp-content. Para mais detalhes, consulta este artigo: Como resolver o WordPress que não cria o ficheiro debug.log.
Dicas adicionais:
- Verifica a compatibilidade do Theme: Por vezes, os Themes também podem causar o ecrã branco da morte. Para verificar se o teu Theme é o problema, muda temporariamente para um Theme predefinido do WordPress como o Twenty Twenty-One.
- Aumenta o limite de memória do PHP: Um limite de memória PHP baixo pode causar uma página branca. Para o aumentar, adiciona a linha seguinte ao teu wp-config.php:
define('WP_MEMORY_LIMIT', '128M');- Limpa a cache: Se estás a usar Plugins de cache, limpa a cache. Por vezes, ficheiros em cache podem causar problemas de apresentação.
- Atualiza o núcleo do WordPress, Plugins e Themes: Garante que a tua instalação WordPress, Plugins e Themes estão atualizados para evitar problemas de compatibilidade.
Seguindo estes passos, deves conseguir diagnosticar e resolver o erro da página branca do WordPress eficientemente.
Se tens dificuldade em interpretar as entradas no ficheiro de log de debug, podes abrir um pedido de suporte e enviar-nos o ficheiro de log.
