Plataformas
Site quebrou depois de atualizar plugin: do sintoma à ação, em ordem
Em 30 segundos
- Pare de atualizar, anote o que mudou e desative só o item que quebrou; restaurar o backup é o último recurso.
- O WordPress manda ao administrador um e-mail com o link do modo de recuperação, que pausa o item com defeito na sua sessão.
- Sem e-mail, renomeie a pasta do plugin em wp-content/plugins pelo gerenciador de arquivos ou por FTP, ou chame o suporte da hospedagem.
- Para a próxima: backup recente, um item por vez, teste numa cópia e conferência de formulário e WhatsApp depois.
Quando o site quebrou depois de atualizar um plugin, não atualize mais nada: abra o e-mail do administrador, que traz o link do modo de recuperação do WordPress, e desative o plugin apontado. Se o e-mail não chegar, renomeie a pasta do plugin pelo painel da hospedagem. Se nada resolver, volte o backup.
A tela branca, o layout desmontado ou a frase "há um erro crítico neste site" aparecem, quase sempre, minutos depois de alguém clicar em "atualizar". A causa mais comum é um plugin ou um tema que não combina com a versão do WordPress, do PHP ou de outro plugin. O caminho de volta é curto se você seguir a ordem certa, e longo se tentar tudo ao mesmo tempo. Abaixo está a árvore do sintoma à ação, o uso do modo de recuperação, o momento de restaurar o backup e a rotina para a próxima atualização não derrubar o site. Se o site já foi feito por alguém que sumiu e você nunca mexeu na parte técnica, saiba que a criação de site institucional da CL3 pode substituir esse site quando ele deixa de se sustentar.
O que fazer quando o site quebra depois de atualizar um plugin?
Pare de atualizar, identifique o que quebrou e desative só esse item; só se isso falhar, restaure o backup. A ordem importa porque cada atualização extra mistura as causas e dificulta voltar. Anote o que você atualizou (plugin, tema, WordPress ou PHP) e a hora. Essa informação sozinha costuma apontar o culpado, e quem for ajudar vai pedi-la primeiro.
Se a página abre mas o site está estranho, trate como defeito de plugin ou de cache. Se a página não abre e mostra tela branca, erro crítico ou erro 500, vá para a tabela abaixo. O erro 500 tem o seu próprio roteiro em o que fazer com o erro 500 no site antes de chamar o técnico.
A árvore de decisão: do sintoma à ação
| O que você vê | Causa mais provável | Ação, na ordem |
|---|---|---|
| Mensagem de "erro crítico" no site | Plugin, tema ou código com erro fatal | 1) Abrir o e-mail do administrador com o link do modo de recuperação. 2) Desativar o item apontado. 3) Sair do modo de recuperação e conferir o site. |
| Tela branca, sem mensagem | Erro fatal sem aviso na tela, ou limite de memória | 1) Procurar o e-mail do modo de recuperação, inclusive no spam. 2) Se não houver, desativar o último plugin atualizado pela pasta. 3) Falar com o suporte da hospedagem. |
| Site abre, mas o layout está desmontado | Plugin ou tema incompatível, ou cache antigo | 1) Limpar o cache do plugin e do navegador. 2) Desativar o plugin recém-atualizado em Plugins. 3) Voltar a versão anterior, se disponível. |
| Erro 500 | Erro de servidor, às vezes causado por plugin ou PHP | 1) Seguir o roteiro do erro 500. 2) Desativar o último plugin. 3) Conferir a versão do PHP. |
| Não entra no painel | Erro fatal que atinge a área administrativa | 1) Link do modo de recuperação do e-mail. 2) Renomear a pasta do plugin pelo gerenciador de arquivos da hospedagem. |
| Nada disso funcionou | Dano maior que o plugin | Restaurar o backup anterior à atualização e pedir ajuda técnica antes de tentar de novo. |
Como usar o modo de recuperação do WordPress?
Quando o WordPress detecta um erro fatal numa visita normal ao site, ele manda um e-mail ao administrador com um link para entrar no modo de recuperação, e nesse modo o plugin ou o tema com defeito fica pausado só na sua sessão. A documentação oficial do modo de recuperação descreve o recurso como um jeito de, em alguns casos, recuperar o acesso sem usar FTP nem editar código, em vez de ficar na tela branca. O passo a passo é curto:
- Abra o e-mail do administrador (o cadastrado em Configurações do WordPress) e clique no link de recuperação.
- Faça login. Você verá um aviso de que o modo de recuperação foi iniciado.
- Procure o aviso que indica qual plugin ou tema falhou e desative-o em Plugins ou em Aparência, Temas. A documentação lembra que isso costuma ser uma solução temporária, mas que traz o site de volta imediatamente.
- Se você editou código, como o arquivo functions.php, corrija antes de continuar.
- Clique em "Sair do modo de recuperação" e confira o site normalmente.
Desativar não é o mesmo que resolver. O plugin que quebrou ainda precisa de uma decisão: procurar uma versão compatível, trocar por outro ou abrir mão da função. Se o plugin era importante (formulário, loja, agendamento), peça ajuda a quem mantém o site antes de reativar. Quais plugins valem a pena num site de empresa, e em que ordem, está em os plugins essenciais do WordPress para empresa.
E se o e-mail do modo de recuperação não chegar?
Desative o plugin pelo gerenciador de arquivos ou por FTP, renomeando a pasta dele, ou peça ao suporte da hospedagem; a própria documentação do WordPress indica esses dois caminhos. Ela explica que o e-mail pode não chegar quando um plugin que muda o envio de e-mails ainda não carregou na hora do erro, e que o servidor pode enviar a mensagem direto, sujeita a cair no spam ou ser bloqueada. O caminho alternativo, segundo a mesma página: se você usa FTP, ou se a hospedagem oferece um gerenciador de arquivos online, pode desativar um ou mais plugins renomeando a pasta, dentro de wp-content/plugins, por exemplo trocando o nome da pasta do plugin acrescentando um número no fim.
- Anote o nome original da pasta antes de renomear.
- Renomeie primeiro o plugin que você acabou de atualizar. Recarregue o site.
- Se o site voltou, entre no painel, reative o plugin com cuidado e leia o aviso que ele mostrar.
- Se não voltou, desfaça o nome e teste o próximo, ou fale com o suporte da hospedagem.
Se o site foi feito há anos por alguém que não responde mais, esse é um dos momentos em que faz falta saber quem tem os acessos. O que você deve ter nas mãos está em o que a manutenção de WordPress inclui.
Quando voltar o backup e o que se perde ao fazer isso?
Volte o backup quando desativar o plugin não traz o site de volta, ou quando houve alteração no banco de dados que você não consegue desfazer; sabendo que tudo o que foi publicado depois da cópia some. Um pedido que entrou na loja, um formulário recebido ou um post publicado depois do backup não volta junto. Por isso a frequência do backup importa. Se o seu último backup tem uma semana, restaurá-lo significa perder uma semana de movimento. Quem faz, onde fica e como restaurar a cópia está em backup do site: quem faz, onde fica a cópia e como restaurar.
Se o site foi atacado e não apenas quebrado, o roteiro é outro: veja WordPress hackeado: como evitar antes, o que fazer durante e o que mudar depois. E se o que quebrou foi a versão do PHP e não um plugin, o relato está em atualizar o PHP do site precisa?.
Como atualizar sem derrubar o site da próxima vez
- Faça um backup recente antes de atualizar e confira que ele existe fora do servidor.
- Atualize um item por vez, e confira o site entre uma atualização e outra. Assim você sabe quem quebrou.
- Teste primeiro numa cópia do site (ambiente de teste), se a sua hospedagem oferece. Em sites de loja, formulário e agenda, isso vale ainda mais.
- Escolha o horário de menor movimento e fique por perto depois.
- Abra o site e teste o que traz contato: formulário, WhatsApp, carrinho. O roteiro de conferência está em o teste de 5 minutos.
- Remova o que não usa. Plugin parado também pede atualização e também pode ser porta de entrada.
Um site lento, cheio de plugins e com atualizações atrasadas costuma quebrar mais; veja WordPress lento, o que fazer. E a conta do que a manutenção custa, mês a mês, ajuda a decidir quem faz isso por você: pagar o site à vista ou por mensalidade.
Quando o site antigo não compensa mais consertar
Se o site quebra a cada atualização, tem plugins abandonados, tema sem suporte e ninguém que o conheça, consertar de novo é pagar pelo mesmo problema. A pergunta de fundo é se o WordPress é a escolha certa para a sua empresa, e ela está em site em WordPress vale a pena? As seis perguntas para fazer a quem propõe. Quando a resposta é refazer, a CL3 cria o site novo a partir de uma conversa sobre o negócio, com proposta por escrito, valor fechado e sem mensalidade obrigatória. A prévia fica num endereço provisório, e o cliente aprova antes de ir ao ar. O domínio é registrado no CNPJ do cliente, e a medição de visitas e contatos fica configurada na entrega. Para os primeiros meses depois da entrada no ar, veja os 90 dias depois do site entrar no ar.
Antes de decidir, a análise de site gratuita dá uma nota de 0 a 100 para o site atual, sem cadastro. O próximo passo, se a escolha é refazer, é juntar o que você tem (textos, fotos, acesso ao domínio e à hospedagem) e pedir a proposta na página de criação de site institucional da CL3.
Perguntas frequentes
O que é o erro crítico do WordPress depois de atualizar?
É a mensagem que o WordPress mostra quando encontra um erro fatal, geralmente causado por plugin, tema ou código. Em vez de uma tela branca, ele exibe o aviso e envia um e-mail ao administrador com o link do modo de recuperação, onde dá para desativar o item que falhou.
Desativar o plugin apaga os meus dados?
Em geral, não: desativar só interrompe o funcionamento do plugin, e os dados continuam no banco. Apagar o plugin é que pode remover configurações, dependendo de como ele foi feito. Por isso, desative primeiro, faça backup e só depois decida entre manter, trocar ou remover. A rotina de manutenção está em o que a manutenção de WordPress inclui.
Quanto tempo o site pode ficar quebrado sem prejudicar o Google?
O Google informa que erros de servidor persistentes fazem as páginas serem descartadas do índice com o tempo, e que o rastreamento diminui durante o erro. Não há prazo exato em dias, então resolva rápido e, se a correção for demorar, use a página de aviso com código 503 em vez de deixar o erro aberto.
Fontes citadas
Os documentos em que este artigo se apoia, na ordem em que aparecem no texto. Abra e confira.
- WordPress.org Documentação: Recovery Mode (modo de recuperação)