Como corrigir mídia que não aparece após migração
O que é a mídia que não aparece após migração?
Após migrar um site, a mídia que não aparece e o estado em que as imagens e arquivos enviados não carregam no destino, embora o conteúdo da página exista. O WordPress guarda os caminhos das imagens no banco (apontando para a URL antiga) e os arquivos fisicos ficam em wp-content/uploads. Se a URL não foi atualizada, se os arquivos não vieram completos ou se as permissões estão erradas, a mídia não renderiza.
Como identificar
- As imagens do conteúdo aparecem como icone quebrado ou caixa vazia no frontend.
- A biblioteca de mídia abre vazia, mesmo com os arquivos presentes na pasta uploads.
- O navegador retorna 404 ao abrir a URL direta de uma imagem em wp-content/uploads.
- As imagens ainda apontam para o domínio antigo no código-fonte da página (URL anterior).
Como prevenir
- Use um plugin de migração confiavel que transfere a pasta uploads e já faz o search-replace da URL
- Confira o tamanho total de wp-content/uploads na origem e no destino para garantir transferencia completa
- Documente plugins de offload de mídia (CDN/S3) antes de migrar, pois a mídia pode estar hospedada fora do site
Causa
- URL antiga ainda gravada no banco de dados, fazendo as imagens apontarem para o domínio anterior.
- Pasta wp-content/uploads transferida de forma incompleta (FTP interrompido ou subpastas por ano/mes faltando).
- Permissões incorretas nos arquivos e pastas de uploads no novo servidor (sem 644/755).
- Tabela de anexos desatualizada: registros em wp_posts apontando para caminhos absolutos do servidor antigo.
- Plugin de offload de mídia (CDN/S3) ativo na origem, com as imagens hospedadas fora e não migradas.
Como resolver
- Confirme a pasta uploads: via FTP, verifique se wp-content/uploads e as subpastas por ano/mes foram transferidas por completo. Pasta incompleta gera 404 direto nos arquivos de imagem.
- Faca o search-replace da URL: substitua a URL antiga pela nova em todo o banco preservando dados serializados, com WP-CLI search-replace ou o plugin Better Search Replace. Isso corrige imagens apontando para o domínio antigo.
- Ajuste as permissões: aplique 644 para arquivos e 755 para pastas em wp-content/uploads via FTP ou SSH, para o servidor servir as imagens.
- Regenere as miniaturas: use o plugin Regenerate Thumbnails para recriar os tamanhos de imagem que possam ter ficado para tras na transferencia.
- Desative o offload de mídia: se a origem usava CDN ou S3 para hospedar a mídia, desative o plugin ou reconfigure o destino, pois as imagens podem não ter vindo no backup.
# WP-CLI: corrige as URLs de midia apontando para o dominio antigo, preservando serializados
wp search-replace 'https://dominio-antigo.com/wp-content/uploads' 'https://dominio-novo.com/wp-content/uploads' --all-tables --report-changes-only
# Teste antes com --dry-run (nao grava nada, so mostra o que mudaria):
wp search-replace 'https://dominio-antigo.com' 'https://dominio-novo.com' --all-tables --dry-runPerguntas frequentes
Por que as imagens quebram mas o texto aparece?
A biblioteca de mídia esta vazia. Os arquivos sumiram?
Como sei se a pasta uploads veio completa?
Posso trocar a URL com um UPDATE de SQL?
As imagens aparecem mas as miniaturas não. Por que?
Usava CDN na origem e a mídia sumiu. O que fazer?
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.
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.
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 backup incremental no UpdraftPlus
O erro de backup incremental no UpdraftPlus ocorre quando falta um backup completo de base, quando o recurso Premium não esta ativo ou quando o agendador do WordPress interrompe o processo, fazendo o incremental não rodar ou parar no meio.
Como corrigir o erro de OneDrive no UpdraftPlus
O erro de OneDrive no UpdraftPlus acontece quando o plugin perde a autorização OAuth com a conta Microsoft e o backup não chega à nuvem. As causas mais comuns são o token de acesso expirado, o espaço esgotado no OneDrive, a pasta de destino apagada ou renomeada e contas OneDrive for Business sem app próprio configurado.
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.
