Por que não consegue iniciar sessão no WordPress após uma migração

Acabou de concluir a migração do seu site WordPress para um novo host. Os ficheiros foram transferidos, a base de dados foi importada e tudo deve estar a funcionar.

Então tenta iniciar sessão no seu painel de administração — e não consegue.

Talvez esteja a receber um loop de redirecionamento ou um erro 404. Ou talvez as suas credenciais simplesmente não estejam mais a funcionar, mesmo que saiba que estão corretas.

Já passei por isso. Não conseguir fazer login é um dos problemas mais comuns que os utilizadores do WordPress enfrentam após uma migração.

O que é realmente tranquilizador nesta situação é que provavelmente não se trata de uma falha catastrófica. Na maioria dos casos, o problema é solucionável e não é necessário ser programador para o resolver.

Neste guia, vou apresentar todas as soluções possíveis. No final, estará de volta ao seu painel, trabalhando no seu site.

Eis as principais conclusões:

• URLs incorretas do banco de dados causam a maioria das falhas de login após a migração; corrija-as no wp-config.php ou diretamente no banco de dados.
• Limpe o cache do navegador e o cache do servidor antes de tentar qualquer correção técnica.
• Um ficheiro .htaccess corrompido do seu servidor antigo pode impedir o login; regenere-o através de Configurações » Permalinks.
• Os plugins de segurança e cache muitas vezes bloqueiam o acesso após a migração; desative os plugins para testar se há conflitos.
• As migrações manuais são propensas a erros; o Duplicator automatiza as atualizações de URL e elimina erros comuns.

Índice

Por que não consegue iniciar sessão no WordPress Admin após uma migração?

Quando migra um site WordPress, está a pegar todo o seu site e colocá-lo num ambiente completamente diferente, com caminhos de ficheiros diferentes e, muitas vezes, um novo nome de domínio.

O WordPress armazena muitas informações específicas do ambiente na sua base de dados e nos seus ficheiros de configuração. Quando essas informações deixam de corresponder, ocorrem falhas.

Aqui estão os motivos mais comuns para o seu login de administrador não funcionar mais.

URLs incorretos na base de dados

O WordPress armazena o URL do seu site em vários locais na base de dados. Se estes não corresponderem ao seu novo domínio (ou se ainda estiverem a apontar para o seu domínio antigo), normalmente verá um ciclo de redirecionamento ou será rejeitado da página de login.

Um ficheiro .htaccess corrompido ou incompatível

O ficheiro .htaccess controla a forma como o seu servidor lida com URLs e redirecionamentos. O ficheiro do seu servidor antigo pode não ser compatível com o novo, especialmente se tiver mudado do Apache para o Nginx ou vice-versa.

Conflitos de plugins ou temas

Alguns plugins (especialmente os de segurança e cache) armazenam configurações específicas do servidor. Após uma migração, eles podem bloquear o seu acesso ou causar erros fatais antes mesmo de você ver a tela de login.

Permissões de ficheiro incorretas

O seu novo servidor pode ter requisitos de permissão diferentes. Se o WordPress não conseguir ler ou gravar os ficheiros de que necessita, irá enfrentar problemas de login.

Ficheiros principais corrompidos

Às vezes, os ficheiros ficam corrompidos durante o processo de transferência. Se ficheiros críticos do WordPress não forem transferidos corretamente, o sistema de login simplesmente não funcionará.

Como resolver problemas de login após uma migração

Execute estas correções por ordem. Comece pelas mais simples primeiro — não faz sentido mergulhar na base de dados se limpar a cache resolver o problema.

Veja como resolver problemas de login no WordPress após uma migração:

• Correções gerais de login do administrador: limpe os caches do navegador e do servidor, verifique as credenciais manualmente e teste os e-mails de redefinição de senha.
• Corrija URLs incorretas em wp-config.php: Substitua os valores do banco de dados adicionando as definições WP_HOME e WP_SITEURL.
• Atualize os URLs diretamente na base de dados: Edite os valores siteurl e home na tabela wp_options com o phpMyAdmin.
• Reinicie o seu ficheiro .htaccess: renomeie o ficheiro antigo e gere um novo através de Definições » Permalinks.
• Verifique se há conflitos entre plugins: renomeie a pasta de plugins para desativar todos os plugins e teste o seu login.
• Redefina manualmente a sua palavra-passe de administrador: atualize o campo user_pass na tabela wp_users
• Substitua os ficheiros principais do WordPress: descarregue as pastas wp-admin e wp-includes atualizadas e carregue-as via FTP.
• Verifique as permissões dos ficheiros: defina as pastas como 755 e os ficheiros como 644 no seu novo servidor.
• Verifique os metadados do utilizador: certifique-se de que wp_capabilities em wp_usermeta contém a função de administrador adequada.
• Ativar depuração: adicione linhas WP_DEBUG ao wp-config.php para identificar mensagens de erro específicas

Correções na autenticação de administrador geral

Antes de entrarmos em qualquer assunto técnico, vamos descartar as coisas simples.

Limpe primeiro a cache e os cookies do seu navegador. Em seguida, e esta é a parte que as pessoas esquecem, verifique se o seu provedor de hospedagem tem cache no nível do servidor.

Hospedeiros como Kinsta, WP Engine e SiteGround têm os seus próprios sistemas de cache. Inicie sessão no seu painel de controlo de hospedagem e limpe o cache também lá.

Verifique as suas credenciais de login a seguir. Sei que já tentou isso, mas faça-me a vontade.

Digite a sua palavra-passe manualmente em vez de usar o preenchimento automático. O preenchimento automático pode, por vezes, preencher credenciais antigas, especialmente se tiver alterado recentemente o seu domínio.

Mesmo que esteja confiante quanto à sua palavra-passe, clique no link Esqueceu-se da sua palavra-passe? e veja se recebe o e-mail de redefinição.

Se não receber o e-mail, isso indica algo útil: o WordPress não consegue enviar e-mails a partir do seu novo servidor. (Isso é um problema à parte, mas pelo menos saberá com o que está a lidar.)

Ainda está bloqueado? É hora de aprofundar a investigação.

Corrigir URLs incorretas

URLs incorretas causam a maioria dos problemas de login após a migração.

O WordPress armazena o URL do seu site na base de dados em dois campos chamados siteurl e home.

Se esses ainda apontam para o seu domínio antigo, o WordPress tentará redirecioná-lo para lá sempre que tentar iniciar sessão. Acabará num ciclo de redirecionamento, saltando entre o URL antigo e o novo até que o seu navegador desista.

Tem duas maneiras de resolver isso.

Método 1: Corrigir URLs incorretas no wp-config.php

A maneira mais rápida de voltar ao seu painel é atualizar o seu ficheiro wp-config.php.

Ligue-se ao seu site através de FTP ou do Gestor de Ficheiros do seu alojamento. Abra o ficheiro wp-config.php no diretório raiz do seu site.

Adicione estas duas linhas perto do topo, logo após a abertura <?php tag:

define( 'WP_HOME', 'https://your-new-domain.com' );

define( 'WP_SITEURL', 'https://your-new-domain.com' );

Substitua seu-novo-domínio.com pelo seu domínio real. Certifique-se de que está a utilizar HTTPS se tiver um certificado SSL instalado (e deve ter).

Guarde o ficheiro e tente iniciar sessão novamente.

Isso substitui tudo o que está na base de dados. Mas aqui está o problema: isso é apenas um paliativo. As URLs incorretas ainda estão na sua base de dados. Para uma correção permanente, é necessário atualizar a própria base de dados.

Método 2: Corrigir URLs incorretas na base de dados

Inicie sessão no phpMyAdmin (encontra-o no painel de controlo do seu alojamento — cPanel, Plesk ou qualquer outro que o seu alojamento utilize). Selecione a sua base de dados WordPress na barra lateral esquerda.

Encontre o wp_options tabela e clique nela. (Se a sua base de dados usar um prefixo diferente, ela poderá ter um nome semelhante a wp_abc123_options.)

Procure duas linhas:

• siteurl
• casa

Clicar Editar em cada um e atualize o option_value campo para o seu novo domínio. Mais uma vez, certifique-se de que está a utilizar o protocolo correto — https ou http.

Guarde as suas alterações. Agora tente iniciar sessão.

Se adicionou essas linhas ao ficheiro wp-config.php anteriormente, pode removê-las agora. A base de dados tem os valores corretos.

Reinicie o seu ficheiro .htaccess

O ficheiro .htaccess controla a reescrita de URLs e redirecionamentos em servidores Apache. Se mudou para um novo servidor (especialmente se a configuração do servidor for diferente), o seu antigo ficheiro .htaccess pode estar a causar problemas.

A solução é simples: gerar um novo.

Ligue-se através de FTP ou gestor de ficheiros. Encontre o ficheiro .htaccess no seu diretório raiz. (Se não o vir, certifique-se de que os ficheiros ocultos estão visíveis no seu cliente FTP.)

Renomeie-o para algo como .htaccess_old. Isso desativa-o sem o excluir.

Tente fazer login agora. Se funcionar, você confirmou que o .htaccess era o problema.

Para gerar um novo ficheiro, inicie sessão no seu painel do WordPress e aceda a Definições » Permalinks. Não altere nada — basta descer a página e clicar em Guardar alterações.

O WordPress criará um novo ficheiro .htaccess com as regras corretas para o seu novo servidor.

Verifique se há conflitos entre plugins e temas

Os plugins de segurança adoram bloquear tudo. Os plugins de cache adoram servir páginas obsoletas. Qualquer um deles pode impedir que você faça login após uma migração.

Veja como testar se há conflitos.

Conecte-se via FTP e navegue até wp-content. Renomeie a pasta plugins para algo como plugins_old.

Tente fazer login. Se funcionar, você saberá que um conflito de plug-ins estava causando o problema.

Agora reative os plugins um de cada vez. Teste o seu login após cada um até encontrar o culpado.

Pode fazer o mesmo com o seu tema ativo. Renomeie a pasta do tema dentro de wp-content/themes. O WordPress irá recorrer a um tema padrão, o que deve permitir que inicie sessão se o problema fosse o seu tema.

Redefinir manualmente a sua palavra-passe de administrador

Talvez a sua palavra-passe tenha realmente sido alterada durante a migração. Isso acontece, especialmente se houver problemas de codificação de caracteres durante a transferência da base de dados.

Pode repor diretamente na base de dados.

Inicie sessão no phpMyAdmin e selecione a sua base de dados WordPress. Abra o wp_users mesa.

Encontre a linha do seu utilizador administrador (normalmente aquela com o ID 1). Clique em Editar.

No user_pass campo, introduza a sua nova palavra-passe. No campo Função menu suspenso ao lado do campo da palavra-passe, selecione MD5. Isso diz ao banco de dados para fazer o hash da sua senha corretamente.

Guarde as alterações e tente iniciar sessão com a sua nova palavra-passe.

Substituir ficheiros principais do WordPress

Pode estar a lidar com ficheiros WordPress danificados. A solução é substituí-los por cópias novas.

Aceda a wordpress.org e transfira a versão mais recente do WordPress (ou a mesma versão que está a utilizar atualmente). Extraia o ficheiro ZIP no seu computador.

Ligue-se via FTP. Navegue até ao diretório raiz do seu site.

Elimine as pastas wp-admin e wp-includes do seu servidor. Carregue as versões atualizadas a partir do download do WordPress que acabou de extrair.

Não toque na pasta wp-content. É onde todos os seus plugins, temas e uploads estão armazenados. Você está apenas substituindo os ficheiros do sistema principal.

Tente iniciar sessão novamente.

Verificar as permissões dos ficheiros

O seu novo servidor pode exigir permissões de ficheiros diferentes das do antigo.

As permissões padrão são:

• Pastas: 755
• Ficheiros: 644

Pode alterá-las através do seu cliente FTP (a maioria tem uma opção de Permissões de Ficheiros ou CHMOD quando clica com o botão direito do rato num ficheiro/pasta) ou através do gestor de ficheiros do seu host.

Verificar metadados do utilizador

Este é mais obscuro, mas já vi acontecer. Às vezes, os dados da função do utilizador ficam embaralhados durante a migração.

Inicie sessão no phpMyAdmin e abra o wp_usermeta mesa.

Encontre a linha onde meta_key é wp_capabilities e user_id corresponde ao seu ID de utilizador administrador (normalmente 1).

Verificar o meta_value campo. Deve conter:

a:1:{s:13:"administrator";b:1;}

Se estiver vazio ou contiver outra coisa, edite-o para corresponder ao texto acima.

Ativar depuração

Se nenhuma das opções acima funcionou, é hora de verificar o que o WordPress está realmente reclamando.

Abra o ficheiro wp-config.php através do FTP. Adicione estas linhas:

define( 'WP_DEBUG', true );

define( 'WP_DEBUG_LOG', true );

define( 'WP_DEBUG_DISPLAY', false );

Isso permite a depuração sem exibir erros no seu site (o que seria um risco à segurança).

Tente iniciar sessão novamente. O WordPress irá agora registar quaisquer erros num ficheiro chamado debug.log no diretório wp-content.

Faça o download desse ficheiro e leia-o. As mensagens de erro geralmente indicam diretamente o problema — um plugin específico, um problema de conexão com o banco de dados ou um ficheiro ausente.

Depois de identificar e corrigir o problema, volte e remova essas linhas de depuração do wp-config.php. Não é recomendável deixar o modo de depuração ativado num site ativo.

Como evitar problemas de login no WP Admin durante uma migração

Então, resolveu o problema. Está de volta ao seu painel. Tudo está a funcionar novamente.

Mas sejamos honestos: isso provavelmente demorou mais do que deveria.

A maioria destes problemas de login resume-se a pequenos erros manuais. Um erro de digitação na base de dados. Esquecer de atualizar os URLs. Transferir um ficheiro que não chegou intacto.

Quando faz tudo manualmente, esses erros são quase inevitáveis. Está a lidar com exportações de bases de dados, uploads FTP e operações de localizar e substituir no phpMyAdmin — há uma dúzia de locais onde um caractere errado pode bloquear o seu acesso.

É por isso que deixei de fazer migrações manuais há anos.

O Duplicator lida automaticamente com todas as partes propensas a erros. Ele foi projetado especificamente para evitar problemas de migração.

O instalador do Duplicator executa uma pesquisa e substituição completas em todo o seu banco de dados. Todos os URLs antigos são atualizados para os novos — não apenas os campos siteurl e home, mas em todos os lugares.

O Duplicator gera um novo ficheiro wp-config.php com base nas credenciais da base de dados que fornece durante a instalação. Também cria um novo ficheiro .htaccess otimizado para o seu novo ambiente de servidor.

Quando utiliza uma ferramenta de migração dedicada, não depende da sua memória ou de uma lista de verificação. O Duplicator realiza uma migração perfeita todas as vezes, na mesma ordem, sem pular etapas. Essa consistência é o que elimina os erros humanos que causam bloqueios.

Não estou a dizer que as migrações manuais são impossíveis. Mas elas exigem foco, atenção aos detalhes e habilidade. Se falhar um passo, vai passar horas a resolver problemas.

O Duplicator elimina essa incerteza. Cria-se uma cópia de segurança, carrega-se no novo host, executa-se o instalador e está feito.

O login funciona porque todos os URLs estão corretos, a configuração está limpa e nada foi corrompido durante a transmissão.

Se você migra sites regularmente (ou se apenas deseja evitar ser bloqueado novamente), vale a pena usar uma ferramenta criada especificamente para essa tarefa.

Perguntas mais frequentes (FAQs)

Inicie sessão no WordPress imediatamente após uma migração

Mesmo quando se sabe o que está a fazer durante uma migração manual, elas são estressantes.

Está a mover dezenas de ficheiros, a exportar bases de dados, a executar operações de localizar e substituir, a atualizar ficheiros de configuração — e a torcer para não ter esquecido nada. Depois, prende a respiração enquanto tenta fazer login, porque, se algo der errado, terá uma hora de resolução de problemas pela frente.

É tempo que não se recupera.

O Duplicator Pro foi criado especificamente para eliminar esse stress. Ele automatiza as partes que causam problemas — substituições de URL, atualizações de configuração, transferências de ficheiros — para que possa migrar com confiança.

Você realizará migrações confiáveis e repetíveis que funcionarão na primeira vez.

Se está cansado de resolver problemas, experimente o Duplicator Pro. É a diferença entre passar a tarde a corrigir uma migração e passar cinco minutos a executar um instalador.

Já que está aqui, acho que vai gostar destes outros recursos do WordPress:

• Como corrigir um site WordPress lento após uma migração
• Seu site WordPress pode desaparecer amanhã (a menos que você faça isso)
• A biblioteca de mídia do WordPress não está mostrando imagens? Corrigi-lo em menos de 15 minutos
• O que fazer quando o acesso ao WordPress é bloqueado
• WordPress preso no modo de manutenção? Veja aqui como reativar o seu site
• A lista de verificação pré-migração que evita desastres na migração de sítios Web