--- title: "Como corrigir erro de serialização após migração" url: https://full.services/wp-fixer/corrigir-serializacao-pos-migracao-wordpress/ date: 2026-06-13 author: "Clayton Margiotti" --- # Como corrigir erro de serialização após migração ## O que é o erro de serializacao apos migracao? 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 migracao troca a URL com find-and-replace cru, o texto muda mas o numero do tamanho nao, e o PHP nao consegue mais ler aquela estrutura. O resultado e widgets, opcoes de tema e ajustes de plugin que somem ou voltam ao padrao. ## Como identificar - Os widgets das areas de widget desaparecem ou voltam vazios apos a migracao. - As opcoes do tema (cores, logo, layout) resetam para o padrao mesmo sem terem sido alteradas. - Configuracoes de plugins se perdem e algumas areas 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 edicao do .sql - Use um plugin de migracao que ja 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 ## Erros relacionados - [Como corrigir site quebrado após migração do WordPress](https://full.services/wp-fixer/corrigir-site-quebrado-pos-migracao-wordpress/) - [Como corrigir URLs quebradas após mudanca de domínio](https://full.services/wp-fixer/corrigir-urls-quebradas-mudanca-dominio-wordpress/) - [Como corrigir mídia que não aparece após migração](https://full.services/wp-fixer/corrigir-midia-nao-aparece-pos-migracao-wordpress/) --- ## Metadados Estruturados (Schema.org) ```json-ld { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://full.services/#org", "name": "FULL Services", "url": "https://full.services/", "sameAs": [ "https://www.instagram.com/fullservicesbr", "https://www.facebook.com/fullservices.br", "https://www.linkedin.com/company/fullservicesbr/" ], "knowsAbout": [ "WordPress", "WordPress Hosting", "Web Development", "Performance Optimization", "WordPress Security", "SEO para WordPress" ], "award": [ "Gold Medal - The WP Weekly Awards 2023", "Gold Medal - The WP Weekly Awards 2024" ], "logo": { "@type": "ImageObject", "url": "https://full.services/wp-content/uploads/full-services-logo.png", "width": 200, "height": 60 }, "hasCredential": { "@type": "EducationalOccupationalCredential", "credentialCategory": "certification", "name": "CVE Numbering Authority (CNA)", "description": "Autoridade de numeração de vulnerabilidades (CVE) para o ecossistema WordPress, autorizada a atribuir IDs CVE. Válida desde 2022-05-03, com abrangência global.", "url": "https://www.cve.org/PartnerInformation/ListofPartners/partner/FULL", "recognizedBy": { "@type": "Organization", "name": "CISA — Cybersecurity and Infrastructure Security Agency", "url": "https://www.cisa.gov/", "sameAs": "https://www.cisa.gov/" } } }, { "@type": "TechArticle", "@id": "https://full.services/wp-fixer/corrigir-serializacao-pos-migracao-wordpress/#article", "headline": "Como corrigir erro de serialização após migração", "url": "https://full.services/wp-fixer/corrigir-serializacao-pos-migracao-wordpress/", "inLanguage": "pt-BR", "datePublished": "2026-06-13T23:44:20-03:00", "dateModified": "2026-06-13T23:44:20-03:00", "author": { "@id": "https://full.services/#org" }, "publisher": { "@id": "https://full.services/#org" }, "isAccessibleForFree": false, "about": [ { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, { "@type": "Thing", "name": "Migracao & Backup" } ], "mentions": { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://full.services/wp-fixer/corrigir-serializacao-pos-migracao-wordpress/" }, "wordCount": 485, "description": "O erro de serializacao apos migracao do WordPress aparece quando widgets somem, as opcoes do tema voltam ao padrao e configuracoes 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.", "articleSection": "Migracao & Backup", "keywords": "configuracoes do tema perdidas migracao, dados serializados quebrados wordpress, search replace serializacao wordpress, widgets sumiram apos migrar wordpress", "proficiencyLevel": "Advanced", "citation": { "@type": "CreativeWork", "url": "https://wordpress.org/documentation/article/moving-wordpress/", "name": "WordPress.org — Moving WordPress" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir erro de serialização após migração", "programmingLanguage": "Shell", "codeRepository": "https://full.services/wp-fixer/corrigir-serializacao-pos-migracao-wordpress/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-serializacao-pos-migracao-wordpress/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-serializacao-pos-migracao-wordpress/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-serializacao-pos-migracao-wordpress/#faq-q1", "name": "O que e um dado serializado no WordPress?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "E uma string PHP que armazena estruturas (arrays, objetos) com o tamanho de cada valor embutido, como s:5:\"valor\". Widgets, opcoes de tema e configuracoes de plugin usam esse formato. Por isso a troca de URL precisa recontar o tamanho, ou o PHP nao le mais o dado.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-serializacao-pos-migracao-wordpress/#faq-q2", "name": "Por que o UPDATE de SQL quebra a serializacao?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Porque o UPDATE troca o texto da URL mas nao atualiza o numero 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 opcoes sumirem ou resetarem.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-serializacao-pos-migracao-wordpress/#faq-q3", "name": "Ja fiz o replace cru e quebrou tudo. Tem volta?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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 opcoes de tema afetados precisam ser reconfigurados manualmente.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-serializacao-pos-migracao-wordpress/#faq-q4", "name": "Better Search Replace e seguro para serializados?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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 opcao de teste antes de gravar para conferir quantas linhas serao alteradas e em quais tabelas.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-serializacao-pos-migracao-wordpress/#faq-q5", "name": "Trocar http por https tambem pode quebrar?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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 edicao do dump.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-serializacao-pos-migracao-wordpress/#faq-q6", "name": "Preciso de SSH para corrigir a serializacao?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Nao obrigatoriamente. O WP-CLI via SSH e o caminho mais robusto, mas o plugin Better Search Replace faz a mesma substituicao tratando serializacao pelo painel. Em ambos, faca backup do banco antes e rode primeiro em modo de teste.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```