Como corrigir mídia que não aparece após migração
Perguntas frequentes
Por que as imagens quebram mas o texto aparece?
Porque o texto fica no banco e as imagens dependem de dois fatores: o caminho gravado no banco (URL) e o arquivo fisico em uploads. Se a URL aponta para o dominio antigo ou o arquivo nao veio, a imagem quebra enquanto o texto, que nao depende de arquivo, continua aparecendo.
A biblioteca de midia esta vazia. Os arquivos sumiram?
Nem sempre. A biblioteca lista anexos a partir do banco (tabela wp_posts); se a URL nao foi atualizada ou os registros apontam para caminhos antigos, ela aparece vazia mesmo com os arquivos na pasta uploads. Faca o search-replace da URL para corrigir.
Como sei se a pasta uploads veio completa?
Compare o tamanho de wp-content/uploads na origem e no destino via FTP ou SSH. Diferencas grandes indicam transferencia incompleta. Verifique tambem se as subpastas por ano e mes existem; falta delas gera 404 direto nas imagens daquele periodo.
Posso trocar a URL com um UPDATE de SQL?
Nao. Muitos dados de midia ficam em campos serializados (metadados de imagem, configuracoes de tema). Um UPDATE cru quebra o tamanho declarado das strings e corrompe esses dados. Use WP-CLI search-replace ou Better Search Replace, que tratam a serializacao.
As imagens aparecem mas as miniaturas nao. Por que?
Os tamanhos gerados (miniaturas) podem nao ter sido transferidos ou o tema novo define dimensoes diferentes. Use o plugin Regenerate Thumbnails para recriar as miniaturas a partir das imagens originais ja presentes na pasta uploads.
Usava CDN na origem e a midia sumiu. O que fazer?
Se um plugin de offload (S3, CDN) hospedava as imagens fora do site, elas podem nao estar no backup. Reative o offload apontando para o mesmo storage, ou baixe os arquivos do CDN antigo e suba para wp-content/uploads no destino antes de corrigir as URLs.














