URLs quebradas após mudar o domínio: como corrigir

Tipo Migracao & Backup

Nome do erro URLs quebradas após mudança de domínio EN: Broken URLs after domain change

Severidade Grave

Descrição URLs quebradas após mudanca de domínio acontecem quando o WordPress passa a usar um novo endereco, mas links internos, imagens e referencias no conteúdo continuam apontando para o domínio antigo. A causa e a URL antiga gravada no banco, que exige search-replace para trocar sem corromper dados serializados.

O que é as URLs quebradas após mudança de domínio?

URLs quebradas após mudança de domínio é o estado em que o site responde no domínio novo, mas o conteúdo ainda referencia o antigo: links internos levam ao endereço velho, imagens não carregam e formulários enviam para o lugar errado. O WordPress grava a URL absoluta em posts, opções e metadados; trocar só siteurl/home não atualiza essas milhares de referências espalhadas pelo banco.

Como identificar

Links internos do menu e do conteúdo levam ao domínio antigo e retornam 404.
Imagens da biblioteca de mídia não aparecem (src ainda aponta para o domínio antigo).
O navegador mostra aviso de conteúdo misto porque recursos carregam do endereço anterior.
Redirecionamentos em loop ou “too many redirects” ao acessar páginas internas.

Antes de começar: Faça backup completo do banco antes do search-replace: ele altera milhares de linhas de uma vez e não há desfazer sem a cópia. Rode sempre um –dry-run antes para conferir o volume de alterações esperado.

Como prevenir

Sempre faça a troca de domínio com WP-CLI search-replace ou Better Search Replace, nunca SQL cru
Mantenha um redirect 301 permanente do domínio antigo para o novo enquanto houver links externos
Use URLs relativas para mídia quando possível e teste em staging antes de apontar o DNS

Causa

URL antiga gravada em milhares de linhas do banco (post_content, guid, wp_options, postmeta).
Apenas siteurl e home alterados, sem substituir as URLs absolutas no conteúdo e nos metadados.
Dados serializados (widgets, opções de tema/plugin) com a URL antiga, que um find-replace cru corromperia.
Cache (plugin ou CDN) servindo páginas antigas com os links do domínio anterior.
Ausência de redirect 301 do domínio antigo para o novo, mantendo links externos quebrados.

Como resolver

Atualize siteurl e home: em Configurações > Geral, defina a URL do WordPress e a URL do site para o novo domínio (ambas em https).
Faça o search-replace no banco: substitua o domínio antigo pelo novo em todas as tabelas preservando dados serializados. Use o WP-CLI (search-replace) ou o plugin Better Search Replace, nunca um UPDATE de SQL cru.
Regenere os permalinks: em Configurações > Links permanentes, clique em Salvar para reescrever o .htaccess e atualizar a estrutura de links no novo domínio.
Configure o redirect 301: no domínio antigo, adicione um redirecionamento 301 para o novo, preservando o caminho, para não perder SEO nem links externos.
Limpe o cache: limpe o cache do plugin e do CDN para que as páginas sejam reconstruídas com os links do domínio novo.

BASH

# WP-CLI: troca o dominio antigo pelo novo em TODO o banco, preservando serializacao
# 1) Simule primeiro (nao grava nada):
wp search-replace 'dominio-antigo.com' 'dominio-novo.com' --all-tables --dry-run

# 2) Aplique de verdade quando o relatorio bater:
wp search-replace 'dominio-antigo.com' 'dominio-novo.com' --all-tables --report-changes-only

# 3) Limpe permalinks e cache de objetos apos a troca:
wp rewrite flush && wp cache flush

Perguntas frequentes

Mudei siteurl e home, mas os links continuam quebrados. Por quê?

Porque siteurl e home só definem o endereço base. As URLs absolutas do domínio antigo continuam gravadas no conteúdo dos posts, nos metadados e nas opções. Só um search-replace em todo o banco substitui essas milhares de referências.

Posso trocar o domínio com find-and-replace direto no SQL?

Não. Widgets e opções de tema/plugin ficam em dados serializados, que guardam o tamanho exato de cada string. Um replace cru quebra esse tamanho e corrompe os dados. Use WP-CLI search-replace ou Better Search Replace.

As imagens sumiram após mudar o domínio. Como corrigir?

O src das imagens ainda aponta para o domínio antigo no banco. Após o search-replace em todas as tabelas, os caminhos passam a usar o novo domínio e as imagens voltam. Limpe o cache para ver o resultado.

Preciso de um redirect 301 do domínio antigo?

Sim, se o domínio antigo ainda recebe acessos ou tem backlinks. O 301 preserva o SEO transferindo a autoridade e evita que links externos quebrem. Configure-o no servidor do domínio antigo apontando para o novo.

Devo incluir o https:// no termo de busca do search-replace?

Rode preferindo só o domínio (ex.: 'domínio-antigo.com') para pegar referências com http, https e protocolo relativo. Se o conteúdo misturava http e https, faça uma passada extra com cada protocolo para não deixar sobras.

Recebo 'too many redirects' após a mudança. O que é?

Geralmente é siteurl/home conflitando com um redirect mal configurado, ou cache antigo. Confirme que ambas as URLs apontam para o domínio novo em https, refaça os permalinks e limpe o cache do plugin e do CDN.

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.

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.

Grave

Como corrigir o backup automático que não roda no UpdraftPlus

O backup automático do UpdraftPlus não roda porque o agendamento depende do WP-Cron, que só dispara quando alguém visita o site, então em sites com pouco tráfego o horário previsto passa sem o backup acontecer. A correção é desativar o WP-Cron interno e criar um cron real do servidor chamando o wp-cron.php em intervalos fixos.

Grave

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.

Atenção

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.

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.

Setores

Extensões

Integrações

Como corrigir URLs quebradas após mudança de domínio

O que é as URLs quebradas após mudança de domínio?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir a falha de clonagem de site no UpdraftPlus

Como corrigir backup do WordPress que falha ao restaurar

Como corrigir o backup automático que não roda no UpdraftPlus

Como corrigir o erro de permissão de pasta no UpdraftPlus

Como corrigir o conflito de GUID após migração no WordPress

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

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