Como corrigir erro de serialização após migração
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.
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.
# 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?
Por que o UPDATE de SQL quebra a serialização?
Já fiz o replace cru e quebrou tudo. Tem volta?
Better Search Replace e seguro para serializados?
Trocar http por https também pode quebrar?
Preciso de SSH para corrigir a serialização?
Como corrigir site quebrado após migração do WordPress
O site quebrado após migração do WordPress aparece com layout sem CSS, imagens faltando, links apontando para o domínio antigo ou tela branca. A causa quase sempre é a URL antiga ainda gravada no banco de dados ou credenciais erradas no wp-config.php do novo servidor.
Como corrigir o erro de permissão de pasta no UpdraftPlus
O erro de permissão de pasta no UpdraftPlus ocorre quando a pasta wp-content/updraft não tem permissão de escrita, deixando o botão Fazer backup agora desativado e impedindo a gravação do arquivo de backup. A correção é ajustar a permissão da pasta para 755 e o dono dos arquivos.
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.
Como corrigir o conflito de GUID após migração no WordPress
O conflito de GUID após migração no WordPress ocorre quando uma busca e substituição troca o GUID dos posts, fazendo leitores de feed tratarem tudo como conteúdo novo e duplicado. A correção é manter o GUID original intocado e corrigir apenas as URLs reais do conteúdo, nunca a coluna guid.
Como corrigir o backup de banco de dados grande que falha no UpdraftPlus
O UpdraftPlus que não faz backup de banco grande trava numa tabela pesada (em geral wp_posts ou wp_options), expira por falta de memória PHP ou para porque o scheduler do WordPress não consegue agendar a retomada. O backup fica preso na mesma porcentagem e nunca chega ao arquivo final.
Como corrigir o erro de FTP no UpdraftPlus
O erro de FTP no UpdraftPlus ocorre quando o plugin gera o backup local mas não consegue enviar os arquivos para o servidor FTP ou SFTP, em geral por firewall do host bloqueando a saida, host digitado no formato errado ou exigencia de conexão criptografada que so a versão Premium suporta.
