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

> A mensagem de erro crítico ou a 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 depois de uma atualização), versão do PHP incompatível e falta de memória. Comece pelo e-mail de modo de recuperação e pelo log de erros.

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](https://developer.wordpress.org/advanced-administration/debug/debug-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

---
Fonte: https://help.staycloud.com/artigos/houve-um-erro-critico-no-seu-site-ou-tela-branca-no-wordpress-o-que-fazer