Ir para o conteúdo
CL3 Marketing Orçamento grátis

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ávelAção, na ordem
Mensagem de "erro crítico" no sitePlugin, tema ou código com erro fatal1) 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 mensagemErro fatal sem aviso na tela, ou limite de memória1) 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á desmontadoPlugin ou tema incompatível, ou cache antigo1) 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 500Erro de servidor, às vezes causado por plugin ou PHP1) Seguir o roteiro do erro 500. 2) Desativar o último plugin. 3) Conferir a versão do PHP.
Não entra no painelErro fatal que atinge a área administrativa1) Link do modo de recuperação do e-mail. 2) Renomear a pasta do plugin pelo gerenciador de arquivos da hospedagem.
Nada disso funcionouDano maior que o pluginRestaurar 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:

  1. Abra o e-mail do administrador (o cadastrado em Configurações do WordPress) e clique no link de recuperação.
  2. Faça login. Você verá um aviso de que o modo de recuperação foi iniciado.
  3. 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.
  4. Se você editou código, como o arquivo functions.php, corrija antes de continuar.
  5. 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

  1. Faça um backup recente antes de atualizar e confira que ele existe fora do servidor.
  2. Atualize um item por vez, e confira o site entre uma atualização e outra. Assim você sabe quem quebrou.
  3. 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.
  4. Escolha o horário de menor movimento e fique por perto depois.
  5. 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.
  6. 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.

  1. WordPress.org Documentação: Recovery Mode (modo de recuperação)
Compartilhar no WhatsApp Marcar a CL3 como fonte preferida no Google

Pronto para ter um site que trabalha pela sua empresa?

Conte o que a sua empresa faz e a gente responde com uma proposta clara, sem enrolação.

Solicitar atendimento