"Houve um erro crítico no seu site" ou tela branca no WordPress: o que fazer

A mensagem "Houve um erro crítico no seu site" ou uma tela branca quer dizer que um erro fatal de PHP parou o WordPress antes de montar a página. As causas mais comuns são: um plugin ou tema com erro (em geral logo depois de uma atualização), uma versão do PHP incompatível com o site e falta de memória. Comece pelo e-mail que o WordPress manda para o administrador, com um link de modo de recuperação, e pelo log de erros do site: os dois dizem qual plugin ou tema falhou.

Atenção: este tutorial mexe na segurança do seu site. As mudanças descritas aqui são feitas por sua conta e risco. Confira cada passo antes de aplicar.

Sintomas

• O site mostra "Houve um erro crítico no seu site" ou "Houve um erro crítico neste site".
• Em inglês: There has been a critical error on this website. ou There has been a critical error on your website.
• A página fica totalmente em branco, sem mensagem, no site ou só no painel do WordPress (/wp-admin).
• O e-mail do administrador do WordPress recebe uma mensagem com o assunto sobre um problema técnico no site e um link de modo de recuperação.

Causa 1: um plugin com erro

Como confirmar: o erro começou depois de instalar ou atualizar um plugin. O e-mail de modo de recuperação diz qual plugin causou o erro. No log de erros, a linha PHP Fatal error aponta para um arquivo em wp-content/plugins/<nome-do-plugin>; veja "Como ver o log de erros do site no cPanel".

Como resolver: abra o link de modo de recuperação do e-mail e desative o plugin indicado. Se não recebeu o e-mail, renomeie a pasta do plugin, por exemplo de wp-content/plugins/nome-do-plugin para nome-do-plugin-off, pelo gerenciador de arquivos; veja "Como usar o gerenciador de arquivos da hospedagem pelo painel". O WordPress desativa o plugin sozinho quando não encontra a pasta. Se não souber qual é, renomeie a pasta plugins inteira, teste e depois volte o nome, reativando um plugin por vez.

Causa 2: o tema com erro

Como confirmar: o caminho no log de erros está em wp-content/themes/<nome-do-tema>, ou o erro começou depois de atualizar ou editar o tema (por exemplo, o functions.php).

Como resolver: desative o tema pelo modo de recuperação, ou renomeie a pasta dele pelo gerenciador de arquivos. Com a pasta renomeada, o WordPress volta a um tema padrão instalado, como o Twenty Twenty-Four. Se o erro veio de uma edição sua, volte o arquivo ao conteúdo anterior.

Causa 3: versão do PHP incompatível

Como confirmar: o erro começou depois de trocar a versão do PHP, ou o log mostra mensagens como Call to undefined function ou Uncaught Error, comuns em plugin ou tema antigo para a versão em uso.

Como resolver: volte para a versão anterior em Software › Selecionar Versão do PHP; veja "Como mudar a versão do PHP do site no cPanel". Depois, atualize os plugins e o tema para versões compatíveis antes de subir o PHP de novo.

Causa 4: falta de memória do PHP

Como confirmar: o log de erros ou o e-mail de recuperação mostram Allowed memory size of ... bytes exhausted.

Como resolver: siga "Erro de limite de memória do PHP: o que fazer".

Causa 5: o erro não aparece em lugar nenhum

Como confirmar: a tela está em branco, não chegou e-mail e o log de erros do cPanel está vazio.

Como resolver: ligue o registro de erros do próprio WordPress. No wp-config.php, acima da linha /* That's all, stop editing! */, coloque:

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

Recarregue a página com erro e abra o arquivo wp-content/debug.log: a última linha mostra o arquivo que falhou. Quando terminar, volte WP_DEBUG para false e apague o debug.log. A explicação oficial está na documentação de depuração do WordPress. Se nada resolver, volte o site a um ponto anterior com "Como restaurar um backup da hospedagem pelo painel".

Quando chamar o Suporte

O suporte da StayCloud cuida da infraestrutura da hospedagem e da configuração dela, não do código do site, do tema nem dos plugins; veja "Perguntas frequentes sobre o que o suporte da StayCloud faz". Abra um chamado se o erro continuar com todos os plugins desativados e um tema padrão, se o debug.log não for criado, ou se precisar de ajuda para restaurar um backup. No chamado, informe o endereço exato que dá erro, o horário, a mensagem que aparece, a última linha do log de erros ou do debug.log e o que você já tentou. O passo a passo está em "Como abrir um chamado no Suporte".

Relacionados

• Como ver o log de erros do site no cPanel
• Como usar o gerenciador de arquivos da hospedagem pelo painel
• Como mudar a versão do PHP do site no cPanel
• Erro de limite de memória do PHP: o que fazer
• Como gerenciar plugins do WordPress pelo painel
• Como restaurar um backup da hospedagem pelo painel
• Erro 500 Internal Server Error no site: o que fazer
• Perguntas frequentes sobre o que o suporte da StayCloud faz
• Como abrir um chamado no Suporte