Fatal error no WordPress: como ler o log e corrigir

Tipo Erro do servidor

Nome do erro Como corrigir There has been a critical error (fatal)

Severidade Crítico

Descrição O fatal error no WordPress é um erro de PHP grave o suficiente para interromper a execução do script e derrubar a página, exibindo "There has been a critical error on this website". Ele vem de código incompatível em um plugin, tema ou no PHP, e só é resolvido lendo o log para encontrar o arquivo e a linha exatos.

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.

Antes de começar: Trabalhe sobre backup do wp-config.php e do functions.php antes de editar. Nunca deixe WP_DEBUG_DISPLAY como true em produção: ele expõe caminhos de arquivos e pistas de estrutura para visitantes mal-intencionados.

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

Erros relacionados

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' );
```

LOG

[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 48

Perguntas frequentes

Onde aparece a mensagem real do fatal error?

No log de PHP, não na tela. Ative WP_DEBUG e WP_DEBUG_LOG no wp-config.php e leia o arquivo wp-content/debug.log: a linha "PHP Fatal error" traz o arquivo, a linha e a causa exata do problema.

Qual a diferença entre fatal error e erro crítico do WordPress?

São a mesma coisa vista de ângulos diferentes. O fatal error é o erro de PHP que interrompe o script; "erro crítico" é o nome amigável da tela que o WordPress mostra ao visitante quando esse fatal error acontece.

O fatal error surgiu depois de atualizar o PHP. O que houve?

Um plugin ou tema usa funções removidas nas versões novas do PHP. Verifique no log qual arquivo falha e atualize esse plugin/tema; se não houver versão compatível, volte temporariamente para a versão de PHP anterior no painel da hospedagem.

Posso corrigir um fatal error sem acesso ao painel?

Sim. Todo o diagnóstico e a correção são feitos por FTP: ativar o log no wp-config.php, ler o debug.log e desativar o plugin ou tema culpado renomeando a pasta dele. O painel volta assim que o componente quebrado é desligado.

"Cannot redeclare function" é fatal error de quê?

De conflito: dois plugins (ou um plugin e o tema) declaram uma função com o mesmo nome. O PHP não permite isso e aborta. Desative um dos dois componentes apontados no log para resolver.

Depois de corrigir, preciso desligar o WP_DEBUG?

Sim. Em produção, deixe WP_DEBUG e WP_DEBUG_DISPLAY como false para não expor caminhos de arquivos. Você pode manter WP_DEBUG_LOG ligado em silêncio se quiser continuar registrando erros sem mostrá-los.

Pro Grave

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.

Crítico

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.

Grave

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.

Pro Atenção

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.

Pro Atenção

Como corrigir upload_max_filesize excedido no WordPress

O limite upload_max_filesize define o maior tamanho de arquivo que o PHP aceita por upload. Quando um vídeo, tema ou plugin passa desse teto, o WordPress recusa o envio com a mensagem de que o arquivo excede o tamanho máximo permitido pelo servidor.

Pro Grave

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.

Setores

Extensões

Integrações

Como corrigir There has been a critical error (fatal)

O que é o fatal error no WordPress?

Como identificar

Como prevenir

Erros relacionados

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir cURL error 28: timeout no WordPress

Erro crítico no seu site: como resolver

Como aumentar o limite de memória PHP no WordPress

Como aumentar max_input_vars no WordPress

Como corrigir upload_max_filesize excedido no WordPress

Como corrigir Maximum Execution Time Exceeded no WordPress

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos