Erro de serialização após migração: como corrigir

Tipo Migracao & Backup

Nome do erro Erro de serialização após migração EN: Serialization error after migration

Severidade Grave

Descrição O erro de serialização após migração do WordPress aparece quando widgets somem, as opções do tema voltam ao padrão e configurações de plugin se perdem. A causa quase sempre e um find-and-replace cru de URL no banco (via SQL ou editor de texto no dump), que quebra o tamanho declarado das strings serializadas armazenadas pelo WordPress.

O que é o erro de serialização após migração?

O WordPress guarda muitos dados em formato serializado: uma string PHP que carrega o tamanho de cada valor, como s:21:”https://exemplo.com/”. Quando uma migração troca a URL com find-and-replace cru, o texto muda mas o número do tamanho não, e o PHP não consegue mais ler aquela estrutura. O resultado e widgets, opções de tema e ajustes de plugin que somem ou voltam ao padrão.

Como identificar

Os widgets das áreas de widget desaparecem ou voltam vazios após a migração.
As opções do tema (cores, logo, layout) resetam para o padrão mesmo sem terem sido alteradas.
Configurações de plugins se perdem e algumas áreas do painel mostram aviso de dado corrompido.
No banco aparecem strings serializadas com tamanho errado, como a:1:{s:21:”…”} com contagem incorreta.

Antes de começar: Faca backup completo do banco antes de qualquer substituicao: a operacao altera milhares de linhas e e irreversivel sem copia. Nunca edite a URL serializada manualmente no dump nem rode UPDATE cru, pois e exatamente isso que gera a corrupcao.

Como prevenir

Sempre troque URLs com WP-CLI search-replace ou Better Search Replace, nunca com UPDATE de SQL ou edição do .sql
Use um plugin de migração que já faz a substituicao tratando dados serializados ao importar
Faca backup do banco antes e rode a substituicao em modo de teste para conferir o resultado

Causa

Find-and-replace cru de URL feito via SQL (UPDATE) sem tratar a serialização, quebrando o tamanho das strings.
Troca de domínio feita editando o arquivo .sql do dump em editor de texto antes de importar.
Diferenca de tamanho entre a URL antiga e a nova (http para https, com ou sem www) alterando a contagem de caracteres.
Plugin de busca e substituicao que não reconhece dados serializados usado na migração.
Caminho absoluto do servidor (ex.: /home/usuário-antigo/) substituido em massa sem recontar o serializado.

Como resolver

Restaure o backup do banco: se você ainda tem o dump original (antes do replace cru), restaure-o para partir de dados serializados integros antes de refazer a troca da forma correta.
Use uma ferramenta que trata serialização: refaca a substituicao de URL com WP-CLI search-replace ou o plugin Better Search Replace, que recontam o tamanho das strings serializadas automaticamente.
Rode em modo de teste primeiro: execute o search-replace com --dry-run (WP-CLI) ou marque "executar como teste" no Better Search Replace para conferir o volume antes de gravar.
Reconfigure o que já quebrou: para widgets e opções de tema já corrompidos por um replace cru anterior, reconstrua-os manualmente, pois o dado serializado pode estar perdido.
Limpe o cache de objetos: limpe o cache (object cache e plugin de cache) para o WordPress reler as opções já corrigidas no banco.

BASH

# CERTO: search-replace que reconta o tamanho das strings serializadas
wp search-replace 'https://dominio-antigo.com' 'https://dominio-novo.com' --all-tables --report-changes-only

# Confira antes com --dry-run, sem gravar nada:
wp search-replace 'https://dominio-antigo.com' 'https://dominio-novo.com' --all-tables --dry-run

# ERRADO (NAO faca): UPDATE cru quebra a serializacao
# UPDATE wp_options SET option_value = REPLACE(option_value,'antigo','novo');

Perguntas frequentes

O que e um dado serializado no WordPress?

E uma string PHP que armazena estruturas (arrays, objetos) com o tamanho de cada valor embutido, como s:5:"valor". Widgets, opções de tema e configurações de plugin usam esse formato. Por isso a troca de URL precisa recontar o tamanho, ou o PHP não le mais o dado.

Por que o UPDATE de SQL quebra a serialização?

Porque o UPDATE troca o texto da URL mas não atualiza o número do tamanho gravado antes da string. Se a URL nova tem comprimento diferente, a contagem fica errada e o PHP descarta a estrutura inteira, fazendo widgets e opções sumirem ou resetarem.

Já fiz o replace cru e quebrou tudo. Tem volta?

A forma mais segura e restaurar o backup do banco anterior ao replace e refazer a troca com WP-CLI search-replace. Sem backup, o dado serializado corrompido geralmente esta perdido e os widgets e opções de tema afetados precisam ser reconfigurados manualmente.

Better Search Replace e seguro para serializados?

Sim. Tanto o Better Search Replace quanto o WP-CLI search-replace reconhecem dados serializados e recalculam o tamanho das strings ao substituir. Use a opção de teste antes de gravar para conferir quantas linhas serão alteradas e em quais tabelas.

Trocar http por https também pode quebrar?

Pode, se feito com replace cru: https tem um caractere a mais que http, mudando o comprimento da string serializada. Mesmo nessa troca aparentemente simples, use search-replace que reconta o tamanho, em vez de UPDATE ou edição do dump.

Preciso de SSH para corrigir a serialização?

Não obrigatoriamente. O WP-CLI via SSH e o caminho mais robusto, mas o plugin Better Search Replace faz a mesma substituicao tratando serialização pelo painel. Em ambos, faca backup do banco antes e rode primeiro em modo de teste.

Grave

Como corrigir mídia que não aparece após migração

A mídia que não aparece após migração do WordPress se manifesta como imagens quebradas no conteúdo, biblioteca de mídia vazia ou erro 404 nos arquivos de uploads. A causa quase sempre e a URL antiga ainda gravada no banco, a pasta wp-content/uploads transferida de forma incompleta, ou permissões incorretas nos arquivos no novo servidor.

Atenção

Como corrigir o conflito de backup e limpeza entre UpdraftPlus e WP Optimize no WordPress

O conflito de backup entre UpdraftPlus e WP Optimize ocorre quando os dois plugins, ambos da TeamUpdraft, rodam no mesmo horario: o WP Optimize apaga revisoes, transients e lixeira ou trava tabelas durante a otimização enquanto o UpdraftPlus copia o banco, gerando um backup incompleto ou inconsistente.

Grave

Como corrigir o erro de tamanho de backup que excede o limite no UpdraftPlus

O erro de tamanho de backup que excede o limite no UpdraftPlus acontece quando um arquivo zip ultrapassa o ponto de divisao (1 GB por padrão), o teto de upload do destino remoto ou os limites de PHP, fazendo o backup falhar ou parar pela metade.

Grave

Como corrigir backup do WordPress que falha ao restaurar

O backup do WordPress que falha ao restaurar trava no meio do processo, expira por timeout ou para com erro antes de concluir. A causa quase sempre e o limite de tempo de execução ou memória do PHP estourado pelo tamanho do arquivo, o upload maior que o upload_max_filesize, ou a importação do banco interrompida por restricoes do servidor.

Atenção

Como corrigir Widget Áreas quebradas no Astra Pro após migração no WordPress

As Astra widget áreas somem após migração quando a sidebar registrada deixa de existir no destino, geralmente porque o Astra Pro ou o módulo Custom Layouts está inativo, o Custom Layout não foi migrado ou o mapa de widgets ficou apontando para um ID de sidebar antigo.

Grave

Como corrigir a falha de clonagem de site no UpdraftPlus

No UpdraftPlus, a clonagem de site falha quando a duplicacao trava ou para no envio com erro. As causas reais são o ModSecurity bloqueando a conexão com os servidores do UpdraftClone (403/502), o timeout do cURL no arquivo grande, o Premium não conectado nos dois lados ou pastas de restauração antigas.

Setores

Extensões

Integrações

Como corrigir erro de serialização após migração

O que é o erro de serialização após migração?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir mídia que não aparece após migração

Como corrigir o conflito de backup e limpeza entre UpdraftPlus e WP Optimize no WordPress

Como corrigir o erro de tamanho de backup que excede o limite no UpdraftPlus

Como corrigir backup do WordPress que falha ao restaurar

Como corrigir Widget Áreas quebradas no Astra Pro após migração no WordPress

Como corrigir a falha de clonagem de site no UpdraftPlus

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos