Como Corrigir Erro Fatal no WordPress

Se o seu site WordPress exibiu a mensagem “Erro fatal” (Fatal Error), isso significa que algum código foi interrompido — geralmente por conflito de plugin, tema, atualização mal-sucedida ou erro de PHP.

A boa notícia: na maioria dos casos, o problema pode ser resolvido rapidamente com os passos certos.

---

✅ 1) Ative o Modo Debug do WordPress (Diagnóstico do Erro)

O primeiro passo é identificar a causa do erro.

Abra o arquivo wp-config.php e adicione ou altere as linhas abaixo:

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

📌 O que isso faz?

• WP_DEBUG: ativa o modo de depuração.
• WP_DEBUG_LOG: salva os erros em arquivo de log.
• WP_DEBUG_DISPLAY: evita exibir erros na tela (mais seguro para produção).

📂 O log será gerado em:

/wp-content/debug.log

---

🔎 2) Analise o Log de Erros

Abra o arquivo debug.log e procure mensagens como:

• nome de plugin
• arquivo PHP específico
• função inexistente
• erro de sintaxe
• incompatibilidade de versão PHP

💡 Exemplos comuns:

• Plugin incompatível com a versão do WordPress
• Tema com função quebrada
• Atualização incompleta
• Erro de PHP (ex: Call to undefined function)
• Conflito entre plugins

---

🧩 3) Desative Plugins (Sem Acesso ao Painel)

Se você não consegue acessar o admin do WordPress:

🔹 Via FTP / File Manager / Plesk / cPanel

1. Acesse a pasta:

wp-content/

2. Renomeie a pasta:

plugins → plugins_old

Isso desativa todos os plugins automaticamente.

✅ Se o site voltar:

• O problema está em algum plugin.
• Renomeie a pasta de volta para plugins.
• Ative os plugins um a um para identificar o causador.

---

🎨 4) Teste o Tema do WordPress

Se o erro for no tema:

1. Acesse:

wp-content/themes/

2. Renomeie a pasta do tema ativo (ex: meutema → meutema_old)

O WordPress ativará automaticamente um tema padrão (como Twenty Twenty-Four).

✅ Se o site voltar:

• O problema está no tema.
• Pode ser erro de código, update mal feito ou incompatibilidade.

---

♻️ 5) Reinstale os Arquivos do WordPress (Sem Perder Dados)

Se o erro persistir:

1. Baixe a versão atual do WordPress.
2. Substitua apenas as pastas:

wp-admin
wp-includes

⚠️ Não substitua a pasta wp-content.

✅ Isso corrige arquivos corrompidos sem perder conteúdo.

---

🧠 6) Verifique a Versão do PHP

Muitos erros fatais ocorrem por incompatibilidade de PHP.

👉 Recomendações:

• PHP 8.0 ou 8.1 (ideal para WordPress moderno)
• Evite PHP 7.2 ou inferior
• Evite PHP 8.2 se plugins não forem compatíveis

Você pode alterar isso no:

• cPanel
• Plesk
• CloudPanel
• Hostinger
• Locaweb
• etc.

---

⚠️ 7) Outros Motivos Comuns de Erro Fatal

✔ Memória insuficiente (PHP Memory Limit)
✔ Arquivo .htaccess corrompido
✔ Conflito com cache (LiteSpeed, WP Rocket, Redis)
✔ Falha em update automático
✔ Plugin pirata ou mal codificado
✔ Funções personalizadas erradas (functions.php)

💡 Dica técnica: aumente a memória do WordPress:

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

---

💾 8) Sempre Faça Backup Antes de Qualquer Alteração

Antes de mexer no site:

• Backup de arquivos
• Backup do banco de dados
• Snapshot do servidor (se possível)

Ferramentas recomendadas:

• UpdraftPlus
• All-in-One WP Migration
• JetBackup (host)
• Backup manual via FTP + phpMyAdmin