Como corrigir There has been a critical error (fatal)
O que é o fatal error no WordPress?
O fatal error no WordPress é um erro de PHP de nível E_ERROR que faz o interpretador parar na hora, sem terminar de montar a página. Diferente de um warning (que apenas alerta), o fatal error é irrecuperável dentro daquela requisição, então o WordPress mostra a tela “There has been a critical error on this website”. A mensagem real (“Uncaught Error”, “Call to undefined function”, “Allowed memory size exhausted”) fica no log de PHP, não na tela do visitante.
Como identificar
- O site mostra “There has been a critical error on this website” (ou, no admin, “…Please check your site admin email inbox for instructions.”).
- No debug.log aparece uma linha começando com “PHP Fatal error: Uncaught Error:” seguida do arquivo e da linha.
- Mensagens típicas como “Call to undefined function”, “Cannot redeclare” ou “Class not found” no log.
- O erro começa logo após atualizar o WordPress, um plugin, um tema ou a versão do PHP.
Como prevenir
- Atualize WordPress, plugins, temas e PHP em um ambiente de teste antes da produção
- Use um plugin de snippets em vez de colar código direto no functions.php
- Mantenha backup automático para reverter rápido quando uma atualização gerar fatal error
Causa
- Plugin chamando uma função removida ou incompatível com a versão atual do PHP (ex.: código PHP 5 rodando em PHP 8.x).
- Conflito entre dois plugins que declaram a mesma função ou classe (Cannot redeclare / Class not found).
- Erro de sintaxe introduzido em functions.php ao colar um snippet de código.
- Arquivo de plugin ou tema corrompido ou incompleto após upload ou atualização interrompida.
- Memória PHP esgotada durante a execução (Allowed memory size exhausted), que também gera fatal error.
Como resolver
- Ative o log de depuração: via FTP, edite o wp-config.php para gravar os erros em arquivo sem mostrá-los ao público:
define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false ); - Leia a linha do fatal error: abra wp-content/debug.log e procure a última linha "PHP Fatal error". Ela indica o arquivo e a linha exatos, normalmente dentro de um plugin (wp-content/plugins/...) ou do tema.
- Desative o componente culpado: se o log apontar um plugin, renomeie a pasta dele em wp-content/plugins via FTP. Se apontar o tema, troque para um tema padrão renomeando a pasta do tema ativo em wp-content/themes.
- Reverta a edição do functions.php: se o erro citar o functions.php do tema, abra o arquivo e remova o último snippet colado, ou restaure o backup. Um ponto-e-vírgula ou chave faltando já causa fatal error.
- Trate falta de memória, se for o caso: se a linha for 'Allowed memory size exhausted', aumente o limite no wp-config.php:
define( 'WP_MEMORY_LIMIT', '256M' );
[13-Jun-2026 14:22:05 UTC] PHP Fatal error: Uncaught Error: Call to undefined function wc_get_product() in /home/site/public_html/wp-content/plugins/meu-plugin/includes/produto.php:48
Stack trace:
#0 /home/site/public_html/wp-content/plugins/meu-plugin/meu-plugin.php(120): render_produto()
#1 {main}
thrown in /home/site/public_html/wp-content/plugins/meu-plugin/includes/produto.php on line 48Perguntas frequentes
Onde aparece a mensagem real do fatal error?
Qual a diferença entre fatal error e erro crítico do WordPress?
O fatal error surgiu depois de atualizar o PHP. O que houve?
Posso corrigir um fatal error sem acesso ao painel?
"Cannot redeclare function" é fatal error de quê?
Depois de corrigir, preciso desligar o WP_DEBUG?
Como corrigir cURL error 28: timeout no WordPress
O cURL error 28 no WordPress é um timeout: o servidor enviou uma requisição HTTP externa (a uma API, ao próprio site ou a um update) e não recebeu resposta dentro do tempo limite. Aparece muito na Saúde do site e no WP-Cron.
Como aumentar o limite de memória PHP no WordPress
Aumentar o limite de memória PHP no WordPress significa elevar o valor de memory_limit que o servidor reserva para cada execução de script. O ajuste resolve travamentos e a mensagem "Allowed memory size exhausted", comuns em sites com muitos plugins, builders ou importações pesadas.
Como corrigir Maximum Execution Time Exceeded no WordPress
O erro Maximum Execution Time Exceeded aparece quando um script PHP ultrapassa o número de segundos que o servidor permite por requisição (padrão 30s). O WordPress aborta a operação no meio, comum em importações, atualizações e backups longos.
Como aumentar max_input_vars no WordPress
O limite baixo de max input vars no WordPress faz o PHP descartar campos quando um formulário, menu ou tela de opções envia mais variáveis do que o teto permite (padrão 1000). O resultado é menu cortado ao salvar e configurações que somem sem nenhum erro visível.
Como resolver Resource Limit Reached (erro 508) no WordPress
O erro Resource Limit Is Reached (508) no WordPress aparece quando o site ultrapassa a cota de CPU, memória, processos ou entradas que o plano de hospedagem permite. O servidor bloqueia novas requisições até o consumo cair.
Erro crítico no seu site: como resolver
O erro crítico no WordPress é a mensagem que substitui o site inteiro por uma tela em branco com o aviso "Houve um erro crítico neste site". Ele aparece quando um erro fatal de PHP (de um plugin, tema ou do PHP em si) impede o WordPress de terminar de carregar a página.
