O que mais de 8.000 tickets de suporte do WordPress revelam sobre por que as migrações falham

Quando uma migração do WordPress falha, o que geralmente acontece? Tínhamos os dados para responder a isso, então investigamos.

Duplicator é um plugin de backup e migração do WordPress que roda em mais de 1,5 milhão de sites. Essa escala produz algo específico e raro: um registro grande e próprio do que acontece quando as pessoas movem um site WordPress.

Nos últimos anos, registramos mais de 8.000 solicitações de suporte estruturadas. Problemas de migração e restauração são nossa maior categoria técnica, e esses tickets são o que este relatório investiga, cada um marcado, categorizado e descrito com as palavras do proprietário do site.

Este relatório é o que esses dados mostram. Parte dele confirma o senso comum. Muito dele não confirma.

Esses números refletem o volume de tickets de suporte, não o número de clientes, instalações ou vendas.

Sumário

Principais Conclusões

Para quem quer os números antes da análise, eis o que os dados dizem sobre o que dá errado durante as migrações do WordPress. Cada número vem dos próprios registros de suporte do Duplicator.

• Problemas de migração e restauração são a maior categoria de suporte técnico. De mais de 8.000 solicitações de suporte, cerca de 4 em cada 10 são técnicas, e pouco menos de um terço delas são migrações, mais do que qualquer outra categoria técnica.
• Migrações raramente falham na etapa de download. Elas falham durante a extração e no primeiro login no novo site.
• O ponto de falha mais comum é um limite do host surgindo na etapa de extração. Em quase 1 em cada 5 tickets de migração, um timeout de PHP ou um limite de memória no servidor de destino paralisa o site enquanto ele descompacta.
• Ficar bloqueado de um site que migrou com sucesso é o segundo problema mais comum, em quase 1 em cada 10 tickets.
• Limites do host são a causa principal, mas raramente se anunciam. Apenas cerca de 1 em cada 50 tickets mencionam um timeout de PHP diretamente, mas o limite de PHP ou memória de um host é o que está por trás da maioria das instalações paralisadas no topo da lista.
• Hospedagens WordPress gerenciadas estão quase ausentes da fila de suporte de migração. Hospedagem compartilhada econômica a domina.
• Cerca de 1 em cada 14 tickets de migração envolve mover um site de um ambiente de desenvolvimento local.
• Problemas de migração são resolvidos rapidamente. Cerca de 2 em cada 3 tickets de migração e restauração são resolvidos em menos de uma hora.

RESUMO: Sua migração provavelmente não falhará enquanto os arquivos são copiados. É mais provável que ela tropece em dois momentos: quando o novo servidor descompacta o site e na primeira vez que você tenta fazer login. Ambos geralmente são corrigíveis em minutos, e o restante deste relatório mostra exatamente como.

Uma ressalva sobre tudo isso, declarada de antemão porque molda como os dados devem ser lidos. Estes são tickets de suporte. Eles capturam migrações que encontraram problemas, não migrações em geral.

As muitas migrações que correram bem nunca geraram um ticket. Portanto, estes dados explicam onde as migrações falham, não com que frequência elas falham.

Migrações são o Maior Problema Técnico Relatado por Usuários do WordPress

Tickets de suporte são um instrumento bruto. Eles também são honestos, porque ninguém abre um quando as coisas estão indo bem.

Agrupamos todos os tickets técnicos por categoria. Problemas de migração e restauração se destacaram, à frente de backups e armazenamento em nuvem.

Cerca de 4 em cada 10 solicitações de suporte são técnicas, e as migrações representam pouco menos de um terço delas. Esse é o sinal mais claro nos dados.

Quando usuários do WordPress atingem um obstáculo técnico sério o suficiente para nos pedir ajuda, uma migração é o motivo mais provável.

Isso se encaixa na natureza da tarefa. Uma migração move tudo de uma vez: arquivos, bancos de dados, URLs, configurações do servidor, versões do PHP e permissões.

Qualquer incompatibilidade única pode quebrar a transferência, e muitas vezes várias acontecem ao mesmo tempo.

Ser a Maior Categoria Não é o Mesmo Que Ser a Mais Difícil

Uma categoria no topo da fila de suporte soa alarmante até você olhar como esses tickets são fechados. Volume e dificuldade não são a mesma coisa.

Tickets de migração e restauração são as solicitações técnicas mais comuns que recebemos. Eles também estão entre os mais rápidos de resolver.

A maioria dos tickets de migração são resolvidos no mesmo dia, muitas vezes em uma única resposta.

Essa combinação, alto volume e resolução rápida, diz algo específico sobre os problemas de migração. Eles são comuns, mas raramente misteriosos.

A maioria remonta a uma curta lista de causas que a equipe de suporte reconhece de imediato, que é exatamente a lista em que este relatório é construído.

Essa também é a razão honesta pela qual podemos escrever este post. Não estamos teorizando sobre por que as migrações falham. Resolvemos milhares delas, a maioria em uma hora.

Onde as Migrações Geralmente Falham e Como Cada Uma é Corrigida

Muitos proprietários de sites culpam um timeout de PHP, um firewall ou espaço em disco por falhas de migração. Em nossos tickets, esses são personagens secundários.

O que realmente dá errado é mais específico e, em quase todos os casos, remonta ao ambiente de destino, não à transferência em si.

Aqui está a análise classificada, com o que geralmente está por trás de cada um e como a equipe de suporte o resolve.

Ponto de falha da migração	Aproximadamente com que frequência	O que geralmente está por trás disso	Como é resolvido
Limite do host interrompe a etapa de instalação/extração	1 em 5	Um timeout de PHP ou limite de memória no servidor de destino está interrompendo o processo no meio da extração	Aumentar os limites de PHP ou usar um instalador projetado para extrair arquivos grandes sem travar (DupArchive)
Bloqueado do wp-admin após a transferência	1 em 10	Uma incompatibilidade de URL do site no banco de dados ou um loop de redirecionamento, não uma migração quebrada	Corrigir as configurações de Endereço do WordPress e Endereço do Site; limpar cookies
Barra de progresso congela no meio da migração	Cerca de 1 em 10	O servidor cortando uma solicitação de longa duração	Aumente os limites de execução ou execute a migração em modo segmentado
Erros de permissão de arquivo ou pasta	Cerca de 1 em 15	Propriedade incorreta ou pastas não graváveis no destino	Corrija as permissões de pasta no novo servidor
Incompatibilidade de versão do PHP	Menos de 1 em 30	A origem foi criada em uma versão mais recente do PHP do que a que o destino executa	Combine as versões do PHP em ambas as pontas antes de migrar
Erro de conexão com o banco de dados	Menos de 1 em 40	Credenciais incorretas do banco de dados no arquivo wp-config.php	Corrija as credenciais durante a instalação
Tempo limite do PHP nomeado diretamente	Cerca de 1 em 50	O limite de execução do host está definido muito baixo para o tamanho do site	Aumente o limite ou divida o trabalho
Erro interno do servidor 500	Menos de 1 em 60	Geralmente um arquivo .htaccess desatualizado ou um problema de permissão	Regenere os links permanentes e as permissões de arquivo

A Etapa de Instalação ou Extração Trava

Esta é a falha de migração mais comum que vemos, e é um limite do host disfarçado. Os arquivos são baixados corretamente, o processo é iniciado e, em seguida, para no meio da extração porque o tempo limite do PHP ou o limite de memória do servidor de destino interrompe o processo no momento de maior trabalho.

A solução é mais margem. Aumente o max_execution_time e o memory_limit do PHP no servidor de destino e execute novamente.

Essas configurações ficam no painel de controle do seu host, geralmente em uma seção chamada PHP Options, MultiPHP INI Editor ou algo semelhante. O suporte do seu host pode aumentá-las se você não as encontrar.

Você também pode usar um instalador criado para extrair arquivos grandes sem acionar esses limites. O instalador autônomo do Duplicator Pro e o formato DupArchive visam exatamente isso, e o DupArchive lidou com migrações reais de até 400 GB.

Você está Bloqueado do wp-admin Após a Mudança

Esta é a falha que mais assusta as pessoas e que menos precisa de atenção. A migração é concluída, você tenta fazer login no novo site e o login falha ou gera um loop de redirecionamento.

Quase nunca significa que a migração falhou. Significa que uma configuração de URL está incorreta. A URL do site armazenada no banco de dados não corresponde a onde o site agora reside, então o WordPress continua redirecionando você para um local que não existe mais.

Verifique os campos Endereço do WordPress e Endereço do Site em Configurações » Geral, corrija-os para a nova URL e limpe seus cookies.

Se você não conseguir acessar o painel de controle, pode definir ambos os valores temporariamente no wp-config.php. Dois minutos de verificação, não uma re-migração.

A Barra de Progresso Congela no Meio da Migração

Próximo parente da "stall" de extração, mas aparece como uma barra de progresso que para de se mover e fica em uma porcentagem indefinida.

A causa geralmente é o servidor cortando uma solicitação de longa duração antes que a etapa possa ser concluída. O trabalho é muito grande para o tempo que o host permite que um único processo seja executado.

Aumente os limites de execução no destino ou execute a migração em um modo que divida o trabalho em pedaços menores para que nenhuma solicitação única seja executada por tempo suficiente para ser encerrada.

No Duplicator, você define isso ao criar o backup. Altere o Database SQL Mode para PHP Code e Multi-Threaded.

Para recursos limitados do servidor, frequentemente recomendamos definir o Server Throttle para Medium ou High nas mesmas configurações.

Erros de Permissão de Arquivo ou Pasta

A migração relata que não consegue gravar um arquivo ou criar uma pasta no novo servidor, e o processo para.

Isso se resume à propriedade e permissão de gravação no destino. Se o usuário do servidor web não for o proprietário das pastas de destino ou se elas não forem graváveis, você não poderá colocar os arquivos onde eles pertencem.

Defina as pastas de destino com a propriedade correta para o seu host e certifique-se de que os diretórios sejam graváveis (geralmente 755 para pastas e 644 para arquivos).

Você altera isso através de um cliente FTP ou do gerenciador de arquivos do seu host, ambos mostram uma opção de permissões ou CHMOD ao clicar com o botão direito em uma pasta. A documentação do seu host confirmará o usuário correto do servidor web, caso você não tenha certeza.

Incompatibilidade de Versão do PHP

Tudo parece bem até que o site restaurado comece a apresentar erros em páginas que usam recursos específicos de plugins ou temas.

A causa usual é uma incompatibilidade de PHP entre os ambientes. O site foi construído em uma versão de PHP mais recente do que o servidor de destino executa, então funções que funcionavam no host antigo estão obsoletas ou ausentes no novo.

Verifique a versão do PHP em ambas as extremidades antes de migrar. Se forem diferentes, atualize o PHP do novo servidor ou atualize o PHP do seu backup.

Você encontrará isso no painel de controle da sua hospedagem, onde a maioria dos hosts permite que você o altere em alguns cliques.

Erro de Conexão com o Banco de Dados

O novo site carrega a mensagem "Erro ao estabelecer uma conexão com o banco de dados" em vez do seu conteúdo.

Após uma migração, isso é quase sempre credenciais de banco de dados incorretas nos arquivos de configuração, em vez de um banco de dados corrompido. O nome do banco de dados, usuário ou senha em wp-config.php não corresponde ao que o novo host realmente criou.

Confirme o nome do banco de dados, nome de usuário, senha e valor do host da sua nova conta de hospedagem, em seguida, atualize o wp-config.php para corresponder.

Esse arquivo fica na pasta raiz do seu site, à qual você pode acessar através do gerenciador de arquivos do seu host ou de um cliente FTP. Se você usou o instalador do Duplicator, esses valores são definidos durante a etapa de instalação, portanto, verifique novamente o que foi inserido lá.

Timeout de PHP ou Limite Máximo de Execução

Menos comum como uma reclamação explícita, mas vale a pena nomear porque é a causa oculta por trás de várias das falhas acima.

O limite de execução do host está muito baixo para o tamanho do site, então uma etapa longa é encerrada antes que possa ser concluída.

Aumente o max_execution_time no destino, ou divida a migração para que nenhuma etapa única demore o suficiente para atingir o limite. Em hospedagens compartilhadas muito restritivas, pergunte ao suporte qual é o limite máximo, pois alguns hosts o limitam independentemente de suas configurações.

Erro Interno do Servidor 500

O novo site retorna um erro genérico 500 sem detalhes, o que o faz parecer pior do que realmente é.

Após uma migração, o culpado mais comum é um arquivo .htaccess desatualizado ou um problema de permissões de arquivo, não um site corrompido.

Regenere seus permalinks visitando Configurações » Permalinks e salvando sem alterar nada. Isso reescreve seu arquivo .htaccess.

Se isso não resolver, confirme se suas permissões de arquivo estão corretas (pastas 755, arquivos 644), pois um problema de permissão gera o mesmo erro genérico. Se você puder acessar o log de erros do seu servidor, ele pode apontar para a linha exata que está causando o 500.

O Padrão de Hospedagem: Categoria Supera Marca

Também analisamos de quais hosts esses tickets de migração vieram. Esta é a parte que é mais fácil de interpretar mal, então teremos cuidado com ela.

A armadilha é simples. O host que gera mais tickets de migração é também um dos mais utilizados.

Mais sites produzem mais tickets, mesmo com uma taxa de falha perfeitamente média. O volume bruto de tickets não é um ranking de qualidade, e não o apresentaremos como tal.

O que sobrevive a essa ressalva é o padrão por categoria, não por marca:

• Hospedagem compartilhada econômica preenche o topo da fila de migração, o que reflete em parte quantos sites WordPress vivem lá em primeiro lugar.
• Hospedagens WordPress gerenciadas estão quase ausentes. As principais plataformas gerenciadas aparecem apenas algumas vezes cada uma em todo o conjunto de dados de migração.
• Ambientes de nuvem e VPS ficam no meio, com seus próprios problemas relacionados à configuração.

Há também um padrão que vale a pena destacar por si só. Cerca de 1 em cada 14 tickets de migração vêm de pessoas movendo um site de um ambiente de desenvolvimento local, ferramentas como Local, XAMPP ou MAMP.

Ir de um laptop para um servidor ativo carrega seus próprios modos de falha, e isso aparece com mais frequência do que você imagina.

Não estamos afirmando que hospedagens gerenciadas nunca têm problemas de migração. Mas o silêncio quase total em nossa fila de suporte corresponde ao que você esperaria de configurações de servidor mais rígidas e versões de PHP consistentes: menos surpresas que atrapalham uma mudança.

Como se Preparar para as Falhas que Realmente Acontecem

Como os dados apontam claramente para dois pontos de falha, é aí que a preparação deve se concentrar. Concentre-se no que os tickets dizem que realmente quebra.

• Combine as versões do PHP em ambas as extremidades. Um site construído em PHP 8.2 que aterrissa em um servidor ainda executando 7.4 gerará erros após a mudança. Você pode verificar a versão no painel de controle de cada host. Confirme ambas antes de começar.
• Certifique-se de que o destino possa concluir a extração. Este é o principal ponto de falha. Dê a ele espaço em disco suficiente, limite de memória PHP e um tempo de execução que não interrompa o processo no meio.
• Tenha o login do seu novo site pronto antes de mudar. A segunda falha mais comum é um bloqueio pós-migração. Conheça suas credenciais de administrador e o URL do novo site com antecedência.
• Verifique as permissões de arquivo no destino. Propriedade incorreta ou pastas não graváveis aparecem com frequência suficiente para merecer uma olhada rápida. Um cliente FTP ou o gerenciador de arquivos do seu host mostrará as permissões de uma pasta ao clicar com o botão direito nela.

É aqui que a própria ferramenta de migração faz o trabalho real. O instalador independente do Duplicator Pro é construído para mover um site para um servidor em branco, mesmo um sem o WordPress instalado. Isso remove toda uma categoria de problemas de extração.

Seu formato DupArchive não tem limite teórico de tamanho de arquivo e já lidou com migrações reais de 400 GB, então sites grandes não engasgam na etapa onde a maioria das migrações para.

E quando uma mudança deixa alguém bloqueado, o URL de recuperação de desastres pode restaurar um site funcional mesmo quando o WordPress não permite o acesso.

Perguntas Frequentes (FAQs)

O Que Mais de 8.000 Tickets de Suporte Mudam Sobre Conselhos de Migração

O valor desses dados não é uma única estatística. É uma correção para onde a atenção deve ser direcionada.

Os dados continuam apontando para os mesmos dois momentos: a etapa de extração e o primeiro login. É aí que as pessoas realmente ficam presas, não na transferência de arquivos que a maioria das preparações se preocupa.

As pessoas costumam ficar presas porque a transferência parou no meio do caminho ou porque uma página de login não as deixa voltar.

Há uma razão pela qual podemos ser tão específicos sobre o que dá errado. Esses problemas chegam constantemente à nossa fila de suporte e a maioria deles é resolvida em menos de uma hora.

Quando você resolve milhares de problemas de migração, os padrões deixam de ser adivinhação e se tornam um mapa. Este relatório é esse mapa.

Declararemos o limite uma última vez, porque é o que mantém a honestidade. Este é um registro de falhas, não de sucessos. Ele se baseia nas palavras que as pessoas usam para descrever suas próprias dificuldades, o que é imperfeito. Mas é real e é em primeira mão.

Antes da Sua Próxima Migração, Crie um Caminho de Volta

A maioria dos problemas de migração são rápidos de resolver assim que você conhece a causa, e os dados comprovam isso: a maioria dos problemas de migração que vemos são resolvidos em menos de uma hora.

O estresse vem de não ter um caminho de volta quando algo para.

Duplicator Pro é usado por mais de 1,5 milhão de profissionais de WordPress para fazer backup, migrar e recuperar seus sites. Seu instalador autônomo e ferramentas de recuperação de desastres são construídos para os dois pontos de falha que esses dados revelam: a etapa de extração e o login bloqueado.

Enquanto você está aqui, acho que você achará estes outros recursos do WordPress úteis:

• Sua Migração de Site Vai Falhar (A Menos Que Você Evite Estes Erros)
• Migração de DNS Feita Corretamente: Como Evitar os Erros Mais Comuns
• Seu Checklist Completo de Migração do WordPress (Do Início ao Fim)
• Como Migrar um Site WordPress GRATUITAMENTE
• Como Mover um Site WordPress para um Novo Hospedeiro