Site quebrado após migração do WordPress: como corrigir

Tipo Migracao & Backup

Nome do erro Site quebrado após migração EN: Broken site after migration

Severidade Crítico

Descrição 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.

O que é o site quebrado após migração do WordPress?

Um site quebrado após migração é o estado em que o WordPress foi movido para outro servidor ou domínio, mas não funciona corretamente no destino: o CSS não carrega (página “crua”), imagens e links apontam para o endereço antigo, ou o site nem abre. Isso ocorre porque a migração copia arquivos e banco, mas o banco ainda guarda referências (URLs, caminhos) do ambiente de origem.

Como identificar

O site abre sem estilo, como texto puro (“o CSS sumiu”).
Imagens e links apontam para o domínio ou caminho antigo e retornam 404.
Tela branca (white screen) ou “Error establishing a database connection” ao abrir.
O wp-admin redireciona para a URL antiga e não permite login.

Antes de começar: Faça backup completo do banco de dados antes do search-replace: a operação altera milhares de linhas e é irreversível sem cópia. Remova as linhas WP_HOME/WP_SITEURL do wp-config.php depois que a URL definitiva estiver gravada no banco.

Como prevenir

Use um plugin de migração confiável que já faz o search-replace da URL ao importar
Faça backup completo de arquivos e banco antes de iniciar qualquer migração
Teste o site em staging com o domínio final antes de apontar o DNS para o novo host

Causa

URL antiga (siteurl/home e referências no conteúdo) ainda gravada no banco de dados após a cópia.
Credenciais de banco erradas no wp-config.php do novo servidor (DB_NAME, DB_USER, DB_PASSWORD, DB_HOST).
Caminho absoluto de arquivos diferente no novo host (uploads e includes apontando para a pasta antiga).
.htaccess ou regras de servidor da origem incompatíveis com o novo ambiente (Apache vs Nginx).
Permissões de arquivos e pastas incorretas após a transferência (FTP sem preservar 644/755).

Como resolver

Confirme o wp-config.php do novo host: compare DB_NAME, DB_USER, DB_PASSWORD e DB_HOST com os dados do painel do novo servidor. Banco copiado mas credenciais antigas geram tela branca ou erro de conexão.
Defina a URL temporariamente no wp-config: se o admin redireciona para o domínio antigo, force a URL nova com WP_HOME e WP_SITEURL no wp-config.php para conseguir entrar e ajustar.
Faça o search-replace da URL no banco: substitua a URL antiga pela nova em todo o banco, de forma a preservar dados serializados. Use o WP-CLI (search-replace) ou a ferramenta Better Search Replace; nunca um find-and-replace cru.
Regenere o .htaccess e os permalinks: em Configurações > Links permanentes, clique em Salvar para reescrever o .htaccess no padrão do novo servidor.
Corrija permissões e limpe cache: aplique 644 para arquivos e 755 para pastas via FTP e limpe qualquer cache (plugin/CDN) para o site renderizar com os caminhos novos.

BASH

# WP-CLI: substitui a URL antiga pela nova em TODO o banco, preservando dados serializados
wp search-replace 'https://dominio-antigo.com' 'https://dominio-novo.com' --all-tables --report-changes-only

# Teste primeiro 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-run

Perguntas frequentes

Por que o CSS some depois de migrar?

Porque o banco ainda guarda a URL antiga em siteurl/home. O WordPress tenta carregar o CSS do domínio anterior, que não responde no novo ambiente. Um search-replace da URL no banco restaura os caminhos e o estilo volta.

Posso trocar a URL com um UPDATE de SQL simples?

Não. Muitos dados no WordPress são serializados (widgets, opções de tema, plugins). 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 serialização.

O site abre em tela branca após migrar. O que checar primeiro?

Comece pelo wp-config.php: confirme as credenciais de banco do novo host (DB_HOST costuma mudar) e ative o WP_DEBUG para ver o erro real. Tela branca geralmente é erro de conexão ou fatal error de plugin/tema.

Migrei e o wp-admin redireciona para o domínio antigo. Como entro?

Force a URL nova adicionando define('WP_HOME','https://novo.com') e define('WP_SITEURL','https://novo.com') ao wp-config.php. Isso permite acessar o painel; depois faça o search-replace no banco e remova as linhas.

Preciso de SSH para corrigir?

Não obrigatoriamente. O WP-CLI (via SSH) é o caminho mais seguro, mas o plugin Better Search Replace faz a mesma troca de URL pelo painel, também preservando dados serializados. Faça backup do banco antes em ambos.

As imagens não aparecem mesmo após o search-replace. Por quê?

Verifique se a pasta wp-content/uploads foi transferida por completo e com as permissões certas (755 nas pastas). Caminhos absolutos antigos ou uploads faltando geram 404 nas imagens mesmo com a URL já corrigida.

Atenção

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.

Grave

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

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.

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 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.

Grave

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.

Grave

Como corrigir o erro de Amazon S3 no UpdraftPlus

O UpdraftPlus erro Amazon S3 acontece quando o plugin não consegue enviar o backup para o bucket: a conexão retorna AccessDenied, SignatureDoesNotMatch ou o bucket não e encontrado. A causa quase sempre e chave de acesso ou secret key erradas, regiao do bucket diferente da configurada, ou o usuário IAM sem permissão de upload.

Setores

Extensões

Integrações

Como corrigir site quebrado após migração do WordPress

O que é o site quebrado após migração do WordPress?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o erro de backup incremental no UpdraftPlus

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

Como corrigir backup do WordPress que falha ao restaurar

Como corrigir o erro de tamanho de backup que excede o limite no UpdraftPlus

Como corrigir o erro de FTP no UpdraftPlus

Como corrigir o erro de Amazon S3 no UpdraftPlus

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