O Yoast SEO quebrado no WordPress quase sempre se anuncia por um destes sinais: as caixas de título e meta description somem do editor, o painel do plugin fica em branco, as colunas de pontuação SEO desaparecem da lista de posts ou o editor de blocos começa a travar. Você abre Plugins → Plugins instalados e o Yoast continua lá, ativo, na versão mais recente. É aí que a receita de desativar e reativar deixa de funcionar.
A causa costuma estar fora do plugin: um conflito com outro plugin, um tema que sobrescreve hooks, cache de objeto servindo dados velhos ou uma tabela corrompida no banco. Por isso, este artigo não começa pela reinstalação. Começa por uma ordem de diagnóstico que separa o que é problema do Yoast do que é problema do site.
Antes de tudo: confirme que o problema é o Yoast
O primeiro passo é responder a uma pergunta simples: o site funciona sem o Yoast? Se a resposta for sim, o problema está no plugin ou na interação dele com algo. Se for não, o Yoast é só mais uma vítima de um erro maior, e você deve tratar o erro de base primeiro.
Para isso, faça o teste em um ambiente controlado. Em produção, use o modo de recuperação do WordPress: acesse wp-admin, e quando o editor acusar erro crítico, clique no link de e-mail enviado pelo próprio WordPress. Ele entra em modo de recuperação e pausa plugins problemáticos sem derrubar o site para os visitantes.
Se você tem acesso a um site de homologação (staging), melhor ainda. A hospedagem normalmente oferece esse recurso no painel. Nele, você desativa o Yoast e observa o comportamento. Se o editor de blocos voltar a funcionar sem o Yoast, o plugin é o ponto de partida. Se continuar travando, o problema é do tema, de outro plugin ou do próprio core.
Ordem de diagnóstico: do mais barato ao mais invasivo
Seguir uma ordem evita que você mexa no banco sem necessidade. Cada etapa isola uma variável e reduz o universo de suspeitos.
- Teste com tema padrão. Ative o Twenty Twenty-Four (ou outro tema padrão que já esteja instalado) e veja se o Yoast volta a renderizar as caixas no editor. Temas que reescrevem o admin ou removem metaboxes costumam ser os culpados.
- Desative todos os plugins e reative um por um. Comece pelo Yoast sozinho. Se ele funcionar isolado, reative os outros em blocos e observe quando o problema reaparece. Esse teste é o mesmo descrito no guia de plugin quebrado no WordPress, e vale para qualquer plugin, não só o Yoast.
- Compare com outro site na mesma hospedagem. Se você gerencia mais de um site no mesmo servidor, instale o Yoast em um deles e veja se o comportamento se repete. Se os dois quebrarem, a suspeita sobe para o servidor: versão do PHP, limite de memória, cache de objeto (Redis ou Memcached) ou módulo de segurança.
- Use o Health Check & Troubleshooting. Esse plugin oficial do repositório cria uma sessão de diagnóstico só para o seu usuário, sem afetar visitantes. Ele permite desativar plugins e trocar o tema apenas para você, o que é a forma mais segura de testar em produção.
- Verifique o cache de objeto e o cache de página. Se o site usa Redis, Memcached ou um plugin de cache agressivo, limpe tudo antes de concluir qualquer coisa. Um cache de objeto servindo uma versão antiga do autoload do Yoast faz o painel parecer quebrado mesmo com o plugin íntegro.
Na prática, a maioria dos casos de Yoast SEO não funciona se resolve nas etapas 1 e 2. Quando não se resolve, o problema costuma estar no banco ou no servidor.
Quando o Yoast some do painel depois de uma atualização
Esse é o cenário mais frustrante: você atualiza o Yoast, o menu desaparece do admin, e reinstalar o plugin não traz nada de volta. Isso acontece porque a reinstalação recria os arquivos, mas não corrige o banco nem o cache.
As causas prováveis são:
- Capacidades de usuário corrompidas. O Yoast registra capacidades próprias. Se a tabela
wp_optionsouwp_usermetaficou inconsistente, o menu some para o seu usuário mesmo sendo administrador. Testar com outro usuário admin ajuda a confirmar. - Tabelas do Yoast corrompidas. O plugin cria tabelas próprias para indexables. Se a atualização foi interrompida, essas tabelas podem ficar em estado inconsistente. O próprio Yoast tem uma ferramenta de SEO → Ferramentas → Reindexação, que recria os indexables.
- Cache de objeto servindo autoload antigo. Se o servidor usa Redis ou Memcached, o cache pode guardar uma versão antiga da lista de plugins e menus. Limpar o cache de objeto costuma resolver.
- Conflito com plugin de segurança ou de gestão. Plugins que gerenciam vários sites às vezes bloqueiam chamadas administrativas do Yoast. Desative temporariamente para testar.
Antes de mexer no banco, faça backup. Um backup recente é o que separa um diagnóstico tranquilo de uma restauração de emergência. Se o seu backup falha com frequência, vale entender por quê no guia de falha de backup no WordPress.
Yoast quebrando o editor de blocos: o que olhar no log do servidor
Quando o Yoast quebra o editor de blocos, o sintoma costuma ser uma tela branca ao abrir um post ou um erro de JavaScript no console. O log do servidor é onde você encontra a causa real.
Ative o WP_DEBUG e o WP_DEBUG_LOG no wp-config.php em ambiente de homologação. O arquivo wp-content/debug.log vai registrar o erro exato. Procure por:
- Fatal error: Allowed memory size exhausted. O Yoast consome memória ao analisar posts longos. Aumentar o
WP_MEMORY_LIMITcostuma resolver. - Call to undefined function ou Class not found. Indica que outro plugin ou o tema carrega uma versão antiga de uma biblioteca que o Yoast também usa.
- Erros de REST API. O editor de blocos depende da REST API. Se um plugin bloqueia
/wp-json/, o Yoast não consegue salvar os dados de SEO e o editor trava.
Se o log não for suficiente, o guia de logs de erro do WordPress mostra como interpretar cada tipo de mensagem. Em muitos casos, o erro que derruba o Yoast é o mesmo que gera um erro 500 no WordPress, só que ainda contido.
Reinstalar o Yoast: quando funciona e quando não resolve
Reinstalar resolve apenas quando o problema está nos arquivos do plugin — instalação corrompida, upload incompleto ou versão parcialmente baixada. Fora disso, é perda de tempo.
O procedimento correto é: desative o Yoast, exclua, reinstale pela tela de plugins e ative. Se o problema persistir, não insista. Passe para a verificação de banco e cache.
Se o Yoast estiver abandonado ou sem atualizações há muito tempo, a decisão muda. Nesse caso, o guia de plugin abandonado no WordPress ajuda a avaliar se vale trocar por outra solução de SEO.
Quando NÃO usar essa ordem de diagnóstico
Se o site está fora do ar e você não tem acesso ao painel, não comece pelo Yoast. A prioridade é restabelecer o acesso. Nesse cenário, renomeie a pasta do plugin via FTP ou SSH para yoast-desativado e veja se o site volta. Se voltar, o problema é o Yoast. Se não voltar, o problema é outro.
Se você não tem acesso a SSH nem a staging, evite mexer no banco em produção. Prefira o Health Check, que não afeta visitantes, e faça backup antes de qualquer alteração.
Por fim, se o erro só aparece em um site específico e você gerencia vários, não trate como caso isolado. Pode ser um plugin que só está naquele site ou uma configuração de servidor diferente. Compare os ambientes antes de concluir.
Erros comuns ao corrigir Yoast SEO quebrado
- Desativar o Yoast e perder as configurações. As configurações ficam no banco, então desativar não apaga nada. Mas excluir o plugin apaga as tabelas. Sempre exporte as configurações antes de excluir.
- Mexer no banco sem backup. Qualquer alteração em
wp_optionsou nas tabelas do Yoast sem backup é risco desnecessário. - Ignorar o cache de objeto. Limpar só o cache de página não resolve quando o problema está no Redis ou Memcached.
- Testar em produção sem modo de recuperação. O WordPress oferece o modo de recuperação justamente para isso. Usar staging ou Health Check evita derrubar o site para os visitantes.
Prevenção: como não repetir o problema em vários sites
A causa mais comum de Yoast SEO quebrado é atualização feita em produção sem teste. Se você administra vários sites, o risco se multiplica: uma atualização problemática pode derrubar o SEO de todos ao mesmo tempo.
Por isso, vale ter um fluxo de homologação. Atualize primeiro em um site de teste, observe se o Yoast continua funcionando, e só depois replique. O guia de atualizações contínuas no WordPress mostra como organizar esse processo sem travar a operação.
Quando o problema se repete em dez sites, a correção manual deixa de ser viável. É aí que faz sentido usar um painel como o 100% WP, que centraliza atualizações, backups e monitoramento — assim, quando o Yoast quebra em um site, você percebe antes de o cliente reclamar e consegue agir em lote, sem abrir cada painel individualmente.
Quando chamar alguém
Se depois de seguir a ordem de diagnóstico o Yoast continua quebrado, e o log do servidor aponta erro de banco ou de servidor, o problema deixou de ser de plugin. Nesse caso, vale acionar quem cuida da hospedagem ou um serviço especializado em correção de erros pós-atualização. Mexer no banco sem conhecer a estrutura pode transformar um problema de SEO em perda de dados.
