Atualizou o WordPress, um plugin ou o tema e, logo a seguir, surgiu um erro crítico, uma página em branco ou uma funcionalidade que deixou de responder. Por vezes, o website continua acessível, mas o painel de administração, os formulários ou a finalização da compra apresentam falhas.
A prioridade é recuperar o serviço sem perder informação nem criar novos problemas. Desativar vários plugins, mudar a versão de PHP e restaurar uma cópia de segurança em sequência pode dificultar a identificação da causa e, numa loja online, comprometer dados recentes.
Em resumo
Quando uma atualização provoca uma falha, siga esta ordem:
- Pare as alterações e identifique o impacto: todo o website, apenas a administração ou uma funcionalidade específica.
- Registe o que foi atualizado e quando começou o problema.
- Verifique o modo de recuperação do WordPress e consulte as mensagens e os registos de erros.
- Preserve o estado atual e confirme que dispõe de uma cópia de segurança utilizável antes de uma intervenção significativa.
- Isole a causa e aplique a correção menos intrusiva, alterando uma variável de cada vez.
- Teste as funções essenciais e investigue a causa antes de repetir a atualização.
Identifique o tipo de falha
A expressão «o WordPress deixou de funcionar» descreve situações diferentes. O sintoma não identifica, por si só, a causa, mas ajuda a escolher a primeira verificação.
| Sintoma | Primeira área a investigar |
|---|---|
| Mensagem de erro crítico ou ecrã branco | Erros PHP, plugins, tema e limites de recursos. |
| Páginas públicas sem estilos ou com elementos avariados | Tema, construtor de páginas, ficheiros CSS/JavaScript e cache. |
Website público normal, mas wp-admin inacessível | Erros no carregamento da administração, plugins e registos do servidor. |
| Falha apenas no formulário, pesquisa ou finalização da compra | Plugin ou integração responsável e respetivas dependências. |
| Mensagem de manutenção que permanece após a atualização | Estado do processo de atualização e eventual ficheiro .maintenance. |
Se o carrinho ou o pagamento falharem, o website pode parecer funcional e, ainda assim, estar a impedir vendas. Avalie a necessidade de suspender temporariamente novas compras até confirmar que o processo é fiável.
Recolha pistas antes de intervir
Comece por anotar o componente atualizado, as versões anterior e atual (quando conhecidas), a hora aproximada da falha, a mensagem apresentada e as páginas afetadas. Uma falha que surge imediatamente após atualizar um plugin torna-o suspeito, mas não prova que exista um defeito nesse plugin: a nova versão pode revelar uma incompatibilidade com o tema, outro plugin, o PHP ou código personalizado.
Verifique o modo de recuperação do WordPress
Desde a versão 5.2, o WordPress dispõe de um modo de recuperação (Recovery Mode) para determinados erros PHP fatais. Quando é acionado, pode enviar ao endereço de email administrativo uma mensagem com informações sobre a falha e uma ligação especial de acesso ao painel.
Nesse modo, o plugin ou tema identificado pode ficar suspenso apenas para a sessão de administração em recuperação. Isto permite investigar sem desativar indiscriminadamente os restantes componentes. Não significa que o website público tenha ficado reparado.
Verifique a caixa de entrada e o spam do endereço administrativo. A mensagem pode não chegar, nomeadamente por problemas no envio de emails. Se não existir uma ligação útil, será necessário recorrer aos registos de erros ou às ferramentas disponibilizadas pelo alojamento. Consulte também a documentação oficial sobre o Recovery Mode.
Consulte os registos de erros
Mensagens como Uncaught TypeError, Call to undefined function ou Allowed memory size exhausted ajudam a distinguir incompatibilidades, funções em falta e problemas de memória. O caminho de um ficheiro — por exemplo, wp-content/plugins/plugin-x/ — fornece uma pista, mas não demonstra necessariamente que esse plugin é a causa principal.
O WordPress inclui as opções WP_DEBUG, WP_DEBUG_LOG e WP_DEBUG_DISPLAY. Quando é necessário ativar o registo de erros, a apresentação pública desses detalhes deve permanecer desativada. Em produção, estas opções exigem cuidados adicionais, incluindo a proteção dos ficheiros de registo e a reposição da configuração após o diagnóstico.
Consulte igualmente os registos de PHP e do servidor disponibilizados pelo alojamento. Um erro registado no mesmo momento da atualização pode ser mais esclarecedor do que novas tentativas de instalação.
Recupere o acesso com a menor alteração possível
Se os registos apontam para um plugin específico, pode ser adequado desativá-lo temporariamente e verificar se a falha desaparece. Caso o painel esteja inacessível, um técnico pode recorrer ao gestor de ficheiros do alojamento para mudar temporariamente o nome da pasta desse plugin, conforme previsto na documentação do WordPress.
Desativar não é o mesmo que corrigir. Se o website volta a abrir, continua a ser necessário perceber por que motivo a atualização falhou e que funcionalidades ficaram indisponíveis. Desativar o WooCommerce, um sistema de reservas ou uma integração de pagamentos pode recuperar uma página, mas interromper uma operação essencial.
Se a causa estiver no tema, nas suas personalizações ou noutro componente, a intervenção deve ser igualmente seletiva. Evite trocar o tema ou desativar todos os plugins sem necessidade: além do impacto funcional, estas ações introduzem novas variáveis no diagnóstico.
E se a falha for de PHP, cache ou instalação incompleta?
A resposta depende do erro encontrado:
- PHP incompatível:
- confirme a versão instalada e os requisitos do WordPress, tema e plugins antes de a alterar. Mudar PHP sem avaliar o conjunto pode criar novas incompatibilidades.
- Estilos ou scripts desatualizados:
- se a falha for visual ou de interação, verifique a cache do navegador, do website ou da CDN e a otimização de CSS/JavaScript. Limpar cache não corrige um erro PHP fatal.
- Atualização interrompida:
- falta de espaço, permissões, limites de execução ou falhas na transferência podem deixar ficheiros incompletos. Após confirmar o estado e preservar os dados, pode ser necessário reinstalar corretamente a mesma versão.
- Mensagem de manutenção persistente:
- o ficheiro
.maintenancepode não ter sido removido. Antes de o apagar, confirme que não existe uma atualização em curso e verifique se o processo terminou corretamente.
Reverter a versão ou restaurar uma cópia de segurança?
Reverter um plugin ou tema para uma versão anterior pode ser a forma mais rápida de recuperar uma função crítica, desde que exista uma cópia fiável e compatível. Antes, confirme a versão que funcionava, os requisitos atuais e eventuais alterações à base de dados. Voltar a uma versão com vulnerabilidades conhecidas também pode introduzir um risco de segurança.
O WordPress tem mecanismos de reversão automática para determinadas atualizações que falham durante a instalação. Isso não equivale a poder desfazer, sem consequências, uma atualização concluída que mais tarde revela uma incompatibilidade.
Restaurar uma cópia completa exige ainda mais cuidado. Antes de o fazer, preserve, se possível, os ficheiros, a base de dados e os registos do estado atual. Confirme também que a cópia anterior ao incidente está íntegra e que pode ser restaurada. A existência de um ficheiro de cópia de segurança não garante um restauro bem-sucedido.
Atenção especial às lojas WooCommerce
Imagine uma loja com uma cópia de segurança das 14h00 e uma falha às 16h30. Nesse intervalo, podem ter entrado encomendas, novos clientes e alterações de stock. Restaurar a base de dados das 14h00 pode eliminar esses registos do website, mesmo que os pagamentos já tenham sido processados pelo prestador de serviços de pagamento.
Por isso, antes de um restauro integral, determine o que mudou desde a última cópia e se é possível recuperar apenas os ficheiros afetados ou preservar e reconciliar os dados recentes. Numa loja WooCommerce para empresas, pode ainda ser necessário salvaguardar dados de integrações comerciais.
Outro cuidado: algumas atualizações do WooCommerce incluem migrações da base de dados. Repor apenas os ficheiros antigos não garante compatibilidade com a estrutura de dados que ficou instalada. Confirme o estado dessas atualizações e das ações agendadas antes de reverter uma versão. O guia oficial de atualização do WooCommerce explica as precauções de cópia de segurança, testes e atualização de dados.
Confirme que o website ficou realmente funcional
A página inicial abrir não é prova suficiente de recuperação. O teste deve acompanhar as funções que a empresa utiliza:
| Website público: | páginas principais, menus, pesquisa, formulários, autenticação e áreas reservadas. |
|---|---|
| Painel de administração: | edição e gravação de conteúdos, produtos, campos personalizados e operações que tinham falhado. |
| WooCommerce: | produtos e variações, carrinho, finalização da compra, métodos de pagamento em modo de teste, portes, impostos, emails, encomendas e integrações. |
| Website multilingue: | versões por idioma, menus, formulários e processo de compra, quando aplicável. |
Verifique ainda os registos para detetar erros que persistam sem afetar imediatamente a navegação. Se a recuperação exigiu deixar um plugin desativado ou regressar a uma versão anterior, essa medida deve ficar registada como temporária, com uma decisão posterior sobre atualização, substituição ou correção.
Prepare a próxima atualização
Depois de estabilizar o website, reproduza a atualização num ambiente de testes (staging) que represente, tanto quanto possível, a configuração de produção. Teste os componentes relacionados antes de repetir a intervenção no website público. Numa loja online, evite que os testes acionem pagamentos reais, emails para clientes ou outras integrações externas.
Vale a pena rever a fiabilidade das cópias de segurança, o procedimento de restauro, as dependências entre plugins, as notas de lançamento, a monitorização e os testes realizados após cada atualização. O objetivo não é impedir atualizações, mas conseguir executá-las e, quando necessário, recuperar com previsibilidade.
Conclusão
Quando um WordPress falha depois de uma atualização, a ordem das decisões faz a diferença: identificar o sintoma, preservar a informação, localizar a causa e corrigir apenas o necessário. Recuperar o acesso é o primeiro resultado; confirmar que as funções essenciais voltaram a operar e compreender a origem da falha é o que permite encerrar o incidente.
