Você clicou em "Atualizar" e agora o site está fora do ar. A tela ficou branca, o painel administrativo não carrega ou o layout está completamente desconfigurado. Esse cenário é mais comum do que parece, e a boa notícia é que quase sempre tem solução.
Neste guia completo, vamos cobrir os sintomas mais frequentes após uma atualização do WordPress, as ferramentas de diagnóstico disponíveis e as soluções passo a passo para recuperar o seu site.
Sintomas Comuns Após uma Atualização
Antes de agir, identifique qual sintoma está afetando o seu site. Cada problema tem uma causa e solução específica.
Tela Branca da Morte (White Screen of Death)
A página fica completamente branca, sem nenhuma mensagem de erro. Pode afetar o site inteiro ou apenas o painel administrativo. Geralmente causada por um erro fatal de PHP em um plugin ou tema incompatível com a nova versão.
Mensagens de Erro PHP
O site exibe mensagens como:
Fatal error: Uncaught Error: Call to undefined function...
Ou:
Parse error: syntax error, unexpected...
Essas mensagens indicam que algum código (plugin, tema ou até o próprio core) não é compatível com a versão do PHP ou do WordPress atualizado.
Layout Quebrado
O site carrega, mas o design está desconfigurado. Menus fora de lugar, colunas desalinhadas, estilos CSS que não carregam. Geralmente causado por incompatibilidade do tema com a nova versão do WordPress.
Painel Administrativo Inacessível
Você consegue ver o site no front-end, mas não consegue acessar /wp-admin . Ou o contrário: o admin funciona, mas o site exibe erro. Pode ser causado por conflito de plugin que afeta apenas uma das áreas.
Erro 500 (Internal Server Error)
O servidor retorna um erro genérico 500. Pode ser causado por arquivo .htaccess corrompido, erro fatal de PHP ou limite de memória excedido durante a atualização.
Erro de Manutenção Permanente
Após uma atualização interrompida, o WordPress pode ficar travado no modo de manutenção, exibindo a mensagem "Brevemente disponível para manutenção programada. Volte em um minuto."
Ações Imediatas: O Que Fazer Primeiro
Mantenha a calma
O pânico leva a decisões precipitadas. Na maioria dos casos, o conteúdo do banco de dados está intacto. O problema geralmente está nos arquivos PHP (plugins, temas ou core).
Verifique se o problema é generalizado
Tente acessar diferentes páginas do site e o painel administrativo. Isso ajuda a delimitar se o problema é global ou restrito a uma área específica.
Consulte os logs de erro
Se você tem acesso ao painel de controle da hospedagem (cPanel, Plesk ou similar), verifique os logs de erro do PHP. Eles indicam exatamente qual arquivo e linha está causando o problema.
No cPanel, os logs geralmente ficam em Métricas > Erros ou no arquivo error_log na raiz do site.
Habilitando o WP _ DEBUG
O WP _ DEBUG é a ferramenta de diagnóstico mais importante do WordPress. Quando ativado, ele exibe mensagens de erro detalhadas em vez da tela branca.
Ativando via wp-config.php
Acesse o arquivo wp-config.php na raiz do WordPress via FTP ou gerenciador de arquivos da hospedagem. Localize a linha:
define( 'WP_DEBUG', false );
E altere para:
define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false );
Com essa configuração:
- WP_DEBUG ativa o modo de depuração
- WP_DEBUG_LOG grava os erros no arquivo wp-content/debug.log
- WP_DEBUG_DISPLAY oculta os erros da tela (importante em sites em produção)
Lendo o debug.log
Após ativar o WP _ DEBUG, acesse a página que apresenta erro e depois abra o arquivo wp-content/debug.log . Você verá mensagens como:
[26-Feb-2026 14:30:22 UTC] PHP Fatal error: Uncaught Error: Call to undefined function alguma_funcao_removida() in /home/usuario/public_html/wp-content/plugins/meu-plugin/main.php:142
Essa mensagem revela exatamente qual plugin ( meu-plugin ), qual arquivo ( main.php ) e qual linha ( 142 ) está causando o erro.
Importante: lembre-se de desativar o WP _ DEBUG depois de resolver o problema, voltando o valor para false .
Acessando o Site via FTP
Quando o painel administrativo está inacessível, o FTP (ou SFTP) é o seu caminho alternativo para gerenciar os arquivos do WordPress.
Conectando via FTP
Use um cliente FTP como o FileZilla. Você vai precisar:
- Host: geralmente o domínio do seu site ou o IP do servidor
- Usuário: o mesmo usuário de FTP da hospedagem
- Senha: senha do FTP (diferente da senha do WordPress)
- Porta: 21 para FTP ou 22 para SFTP
As credenciais de FTP ficam disponíveis no painel de controle da sua hospedagem.
Estrutura de diretórios do WordPress
Após conectar, navegue até a pasta raiz do WordPress (geralmente public_html ou www ). A estrutura principal é:
public_html/ ├── wp-admin/ ├── wp-content/ │ ├── plugins/ │ ├── themes/ │ └── uploads/ ├── wp-includes/ ├── wp-config.php └── .htaccess
Os arquivos que você mais vai precisar editar estão na pasta wp-content e no wp-config.php .
Desativando Plugins via FTP
Se o erro está sendo causado por um plugin incompatível, você pode desativar todos os plugins via FTP sem precisar do painel administrativo.
Método 1: renomear a pasta plugins
- Via FTP, navegue até wp-content/
- Localize a pasta plugins
- Renomeie para plugins_desativados (ou qualquer outro nome)
- Tente acessar o site novamente
Se o site voltar a funcionar, o problema é um dos plugins. Agora, renomeie a pasta de volta para plugins . Todos os plugins estarão desativados.
Método 2: identificar o plugin problemático
Para descobrir qual plugin específico está causando o problema:
- Renomeie a pasta plugins para plugins_desativados
- Crie uma nova pasta vazia chamada plugins
- Mova os plugins um por um da pasta plugins_desativados para plugins
- Após mover cada plugin, acesse o painel e ative-o
- Quando o erro voltar, você encontrou o plugin problemático
Método 3: desativar um plugin específico
Se o debug.log já indicou qual plugin está com erro, basta renomear a pasta desse plugin específico:
wp-content/plugins/plugin-problematico/
Renomeie para:
wp-content/plugins/plugin-problematico_DESATIVADO/
O WordPress não vai mais reconhecer esse plugin e ele ficará desativado.
Trocando para o Tema Padrão via FTP
Se o problema for o tema, você pode forçar o WordPress a usar um tema padrão.
Renomeando a pasta do tema ativo
- Via FTP, navegue até wp-content/themes/
- Localize a pasta do tema ativo (ex: flavor , flavor-developer , flavor-developer-developer )
- Renomeie a pasta (ex: flavor_DESATIVADO )
- Acesse o site
O WordPress vai detectar que o tema ativo não existe mais e automaticamente ativar um tema padrão (Twenty Twenty-Five, Twenty Twenty-Four, etc.), desde que um deles esteja instalado.
Garantindo que um tema padrão está disponível
Se nenhum tema padrão estiver instalado, faça o download de um tema padrão diretamente do repositório do WordPress (ex: Twenty Twenty-Five) e envie a pasta descompactada via FTP para wp-content/themes/ .
Fazendo Rollback do WordPress Core
Se a atualização do próprio WordPress causou o problema, é possível fazer o downgrade manual para a versão anterior.
Passo a passo do downgrade manual
- Descubra qual versão estava instalada antes da atualização. Verifique o arquivo wp-includes/version.php ou os logs de atualização
- Baixe a versão anterior no site oficial: https://wordpress.org/download/releases/
- Descompacte o arquivo no seu computador
- Via FTP, substitua as pastas wp-admin e wp-includes pelos arquivos da versão anterior
- Substitua os arquivos da raiz (exceto wp-config.php e .htaccess )
- Nunca substitua a pasta wp-content , pois ela contém seus temas, plugins e uploads
Cuidados importantes
- Faça backup antes de qualquer substituição de arquivos
- O downgrade do core pode causar incompatibilidade com o banco de dados se a atualização incluiu mudanças no schema
- Essa solução é temporária. O ideal é identificar e resolver a causa real do problema
Fazendo Rollback de Plugins
Usando o plugin WP Rollback
Se o painel administrativo está acessível, o plugin WP Rollback permite reverter qualquer plugin do repositório oficial para uma versão anterior:
- Instale e ative o plugin WP Rollback
- Vá em Plugins > Plugins Instalados
- Clique em "Rollback" abaixo do plugin que deseja reverter
- Selecione a versão anterior
- Confirme o rollback
Rollback manual via FTP
- Acesse o repositório do WordPress e baixe a versão anterior do plugin
- Via FTP, renomeie a pasta atual do plugin (ex: plugin-nome_BACKUP )
- Envie a pasta do plugin na versão anterior para wp-content/plugins/
- Acesse o painel e verifique se o plugin está ativo
Restaurando a Partir de Backup
Se nenhuma das soluções acima resolver, restaurar um backup feito antes da atualização é a opção mais segura.
Backups da hospedagem
A maioria das hospedagens de qualidade oferece backups automáticos. Verifique no painel de controle:
- cPanel: procure por "Backup" ou "JetBackup"
- Plesk: vá em "Websites & Domains" e procure por "Backup Manager"
- Painéis personalizados: procure a seção de backups
Backups de plugins
Se você usa plugins de backup como UpdraftPlus, BlogVault ou BackWPup, verifique se existe um backup recente anterior à atualização.
Restauração parcial
Em muitos casos, não é necessário restaurar o site inteiro. Você pode:
- Restaurar apenas os arquivos (plugins e temas), mantendo o banco de dados atual
- Restaurar apenas o banco de dados, mantendo os arquivos atuais
- Restaurar arquivos específicos de um plugin ou tema
Corrigindo Problemas no Banco de Dados
Algumas atualizações incluem mudanças na estrutura do banco de dados. Se a atualização foi interrompida, o banco pode ficar em um estado inconsistente.
Ferramenta de reparo do WordPress
O WordPress tem uma ferramenta de reparo embutida. Para ativá-la, adicione ao wp-config.php :
define( 'WP_ALLOW_REPAIR', true );
Depois, acesse: https://seusite.com/wp-admin/maint/repair.php
Você terá duas opções:
- Reparar banco de dados: corrige tabelas com erros
- Reparar e otimizar banco de dados: corrige e otimiza as tabelas
Importante: remova a linha WP_ALLOW_REPAIR do wp-config.php após usar a ferramenta, pois ela pode ser acessada sem autenticação.
Usando phpMyAdmin
Para diagnóstico mais detalhado:
- Acesse o phpMyAdmin pela hospedagem
- Selecione o banco de dados do WordPress
- Marque todas as tabelas
- No menu dropdown, selecione "Verificar tabela"
- Se alguma tabela mostrar erro, selecione-a e clique em "Reparar tabela"
Forçando a atualização do banco
Se a atualização do banco de dados foi interrompida, acesse:
https://seusite.com/wp-admin/upgrade.php
Essa URL força a execução do script de atualização do banco de dados.
Removendo o Arquivo de Manutenção
Se o WordPress ficou travado no modo de manutenção ("Brevemente disponível para manutenção programada"), a solução é simples:
- Via FTP, acesse a raiz do WordPress (pasta public_html )
- Procure por um arquivo chamado .maintenance
- Delete esse arquivo
- Acesse o site novamente
O WordPress cria esse arquivo temporário durante atualizações e o remove automaticamente ao finalizar. Se a atualização foi interrompida, o arquivo permanece e trava o site.
Corrigindo o .htaccess
Um arquivo .htaccess corrompido pode causar Erro 500 após uma atualização.
Testando se o .htaccess é o problema
- Via FTP, renomeie .htaccess para .htaccess_backup
- Tente acessar o site
Se o site voltar, o problema era o .htaccess . Vá ao painel administrativo em Configurações > Links Permanentes e clique em "Salvar Alterações" para regenerar o arquivo.
Conteúdo padrão do .htaccess
Se precisar recriar o arquivo manualmente, o conteúdo padrão do WordPress é:
# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress
Aumentando o Limite de Memória
Atualizações podem exigir mais memória PHP. Se o limite for muito baixo, o processo pode falhar.
Adicione ao wp-config.php , antes da linha "Isto é tudo":
define( 'WP_MEMORY_LIMIT', '256M' ); define( 'WP_MAX_MEMORY_LIMIT', '512M' );
Ou no php.ini :
memory_limit = 256M
Ou no .htaccess :
php_value memory_limit 256M
Prevenção: Como Evitar Problemas em Futuras Atualizações
Use um ambiente de staging
Antes de atualizar o site em produção, teste em um ambiente de staging (cópia do site). Muitas hospedagens oferecem essa funcionalidade com um clique.
Faça backup antes de atualizar
Essa é a regra de ouro. Sempre faça um backup completo (arquivos e banco de dados) antes de qualquer atualização. Se algo der errado, a restauração é rápida.
Atualize um componente por vez
Não atualize o WordPress, todos os plugins e o tema de uma só vez. Atualize um componente, teste, e depois passe para o próximo. Isso facilita a identificação de qual atualização causou o problema.
Leia os changelogs
Antes de atualizar, verifique o changelog (registro de mudanças) da nova versão. Procure por avisos de breaking changes, requisitos de PHP e incompatibilidades conhecidas.
Mantenha o PHP atualizado
Plugins e temas modernos exigem versões recentes do PHP. Manter o PHP desatualizado aumenta as chances de conflito após uma atualização do WordPress.
Remova plugins e temas inativos
Plugins e temas desativados ainda podem causar conflitos. Se você não está usando, remova completamente.
Leia Também
Conclusão
Um WordPress quebrado após atualização pode parecer assustador, mas na grande maioria dos casos o problema tem solução. A sequência recomendada é: ativar o WP _ DEBUG para identificar a causa, desativar plugins e temas via FTP para isolar o conflito, e restaurar do backup como último recurso.
A melhor estratégia, porém, é a prevenção. Backups regulares, ambiente de staging e atualizações graduais eliminam quase todos os riscos.
Se você quer ter a tranquilidade de uma hospedagem que faz backups automáticos diários, oferece ambiente de staging e conta com suporte técnico especializado em WordPress, conheça a HOSTWP . Nossos planos incluem gerenciamento proativo para que você nunca fique na mão após uma atualização. Conheça a HOSTWP e mantenha seu site sempre estável e atualizado.