Site WordPress quebrou depois da atualização: como voltar à versão anterior

O que foi atualizado?

Quatro elementos são atualizados em um site WordPress, e cada um volta atrás de um jeito diferente: o núcleo do WordPress, os plugins, o tema e a versão do PHP do servidor, que a hospedagem atualiza por conta própria. Para saber qual deles mudou:

• Os e-mails do WordPress: depois de uma atualização automática, o WordPress escreve para o endereço de administração do site, com um assunto como “[Nome do site] Alguns plugins foram atualizados automaticamente”, e a lista do que mudou.
• A tela de plugins: a coluna “Atualizações automáticas” mostra os plugins que se atualizam sozinhos, e cada linha exibe a versão instalada.
• Ferramentas > Diagnóstico > Informação: a seção Servidor dá a versão do PHP, e as seções de plugins e de temas, a versão de cada componente.
• As datas das pastas: uma pasta de plugin reescrita por uma atualização leva a data dessa atualização.

wp plugin list
ls -lt wp-content/plugins | head

O primeiro comando lista os plugins com a versão e o estado de cada um; o segundo, as pastas de plugins da modificada mais recentemente à mais antiga. Cruze essas informações com o horário em que o site mudou.

Limpar os caches antes de concluir

Depois de uma atualização, os arquivos CSS e JavaScript mudam de conteúdo, e um cache pode continuar servindo os antigos. O resultado parece uma pane: layout desmontado, menus que não abrem mais. Limpe, nesta ordem, o cache do plugin de cache ou de otimização, o cache da hospedagem se ela oferecer um, e depois o do navegador, e recarregue a página. Se o site voltar, a atualização não era a causa.

O site fica preso em manutenção

Durante uma atualização, o WordPress cria um arquivo .maintenance na raiz do site e exibe “Momentaneamente indisponível para manutenção programada. Confira novamente em um minuto.” Quando a atualização é interrompida, o arquivo fica no lugar. O WordPress o ignora dez minutos depois do horário registrado nele; para não esperar, ou se a mensagem persistir, exclua-o por SFTP ou pelo gerenciador de arquivos da hospedagem. Como o nome começa com um ponto, ative a exibição de arquivos ocultos para vê-lo.

Depois, vá a Painel > Atualizações: o item cuja atualização foi interrompida precisa ser atualizado de novo, ou reinstalado na versão anterior.

Voltar à versão anterior de um plugin

Reinstalar a versão anterior substitui os arquivos do plugin e mantém as configurações dele, que ficam no banco de dados.

wp plugin install nome-do-plugin --version=2.4.1 --force

• Plugin do diretório do WordPress.org: na página pública do plugin, o link “Visualização avançada” leva à lista “Versões anteriores”. Baixe o arquivo compactado desejado e depois, na tela “Instalar plugins”, clique em “Enviar plugin”: o WordPress reconhece o plugin já instalado e propõe “Substituir o atual pelo enviado”.
• Plugin comprado de um desenvolvedor: as versões anteriores em geral podem ser baixadas na área do cliente, no site dele.
• Em seguida: clique em “Desativar atualizações automáticas” ao lado desse plugin, até que o desenvolvedor publique uma correção.

O WordPress já sabe voltar atrás sozinho em dois casos. Desde a versão 6.3, quando a atualização de um plugin ou de um tema falha no meio do caminho, a versão antiga é recolocada. Desde a versão 6.6, quando a atualização automática de um plugin ativo provoca um erro fatal, o WordPress reinstala a versão anterior. Uma atualização que termina e quebra uma função sem erro fatal precisa ser revertida à mão.

O tema: a versão anterior, e as alterações perdidas

wp theme install nome-do-tema --version=3.1.0 --force

Uma atualização de tema substitui todos os arquivos dele. Alterações feitas diretamente nos arquivos do tema, por exemplo no functions.php ou em uma folha de estilo, desaparecem então a cada atualização. O backup feito antes da atualização permite recuperá-las; para mantê-las de forma duradoura, elas vão para um tema filho, que as atualizações do tema pai deixam intacto.

O núcleo do WordPress

O WP-CLI reinstala uma versão precisa do núcleo:

wp core update --version=7.0 --force

Uma atualização principal do núcleo também pode mudar a estrutura do banco de dados, que esse comando deixa como está. O caminho mais seguro muitas vezes é manter o núcleo atualizado e voltar atrás no plugin ou no tema incompatível. Se voltar o núcleo for indispensável, faça isso a partir de um backup completo feito antes da atualização.

A versão do PHP, trocada pela hospedagem

As hospedagens atualizam a versão do PHP à medida que as antigas deixam de receber correções de segurança. Um plugin ou um tema antigo pode então parar em um erro fatal. O painel da hospedagem em geral permite escolher a versão do PHP do site:

1. Anote a versão atual e depois volte à anterior.
2. Verifique se o site voltou a funcionar.
3. Atualize ou substitua o componente em causa, identificado pelo log de depuração.
4. Volte para a versão recente.

Esse retorno é uma etapa de solução de problemas: uma versão do PHP sem correções de segurança expõe o site. Segundo o calendário oficial publicado no php.net, o PHP 8.1 não recebe mais correções de segurança desde 31 de dezembro de 2025, o PHP 8.2 recebe até 31 de dezembro de 2026 e o PHP 8.3 até 31 de dezembro de 2027. O WordPress recomenda o PHP 8.3 ou superior.

Restaurar um backup completo, como último recurso

Uma restauração recoloca os arquivos e o banco de dados no estado do backup. Tudo o que o site recebeu desde então desaparece: pedidos, mensagens de formulário, comentários, cadastros, posts publicados.

1. Exporte primeiro o que chegou desde o backup: pedidos, entradas de formulários, novas contas.
2. Restaure arquivos e banco de dados do mesmo momento, pela ferramenta da hospedagem ou pelo plugin de backup. Arquivos de um dia e um banco de dados de outro dia produzem erros difíceis de ler.
3. Importe de novo os dados exportados.
4. Reaplique as atualizações uma a uma, verificando o site entre cada uma: a última aplicada antes da pane é a que a causa.

Para a próxima atualização

• Uma cópia de teste: muitas hospedagens oferecem um ambiente de homologação (staging) que copia o site em um clique. As atualizações são aplicadas ali primeiro.
• Um backup logo antes, arquivos e banco de dados juntos.
• Uma atualização de cada vez, com uma verificação das páginas principais entre cada uma: página inicial, formulário de contato, carrinho.
• O registro de alterações do plugin ou do tema, lido antes de uma atualização principal.