Checklist do Administrador do OneDrive: Sincronização de Biblioteca Compartilhada Fica Pendente em Migrações de Departamento

Quando você migra dados de um departamento entre sites do SharePoint ou contas do OneDrive, a sincronização de bibliotecas compartilhadas frequentemente fica pendente. Os usuários veem o ícone de sincronização girando ou mostrando um símbolo de relógio por horas. Isso acontece porque o cliente de sincronização precisa reindexar a biblioteca após a migração alterar o local do arquivo ou os metadados. Este artigo explica por que a sincronização de bibliotecas compartilhadas fica travada, lista as verificações exatas que um administrador deve executar e fornece as etapas para forçar a conclusão da sincronização sem perda de dados.

Por que a Sincronização de Biblioteca Compartilhada Fica Travada Após a Migração do Departamento

Quando você move um departamento de um site do SharePoint para outro, o cliente de sincronização do OneDrive não sabe automaticamente o novo local. O cliente tenta sincronizar arquivos com base na URL e no GUID do site antigo. Se o site antigo não existe mais ou as permissões mudaram, o mecanismo de sincronização marca a biblioteca como pendente e nunca conclui.

Causa Raiz: Metadados de Sincronização Desatualizados

O cliente de sincronização do OneDrive armazena um banco de dados local com caminhos de arquivos, IDs de site e tokens de sincronização. Após a migração, o token da biblioteca antiga se torna inválido. O cliente envia uma solicitação ao SharePoint, mas recebe um erro ou um redirecionamento. Em vez de atualizar o caminho, o cliente entra em um loop de repetição. Esse loop mostra o estado pendente indefinidamente.

Causa Raiz: Incompatibilidade de Permissões

Migrações de departamento geralmente envolvem recriar grupos de segurança ou atualizar associações de grupos do Azure AD. Se a conta do usuário não tiver acesso explícito à nova biblioteca, o cliente de sincronização não consegue baixar a lista de arquivos. O cliente mostra pendente porque não consegue enumerar os itens.

Causa Raiz: Limites de Nome de Arquivo ou Comprimento do Caminho

Arquivos migrados às vezes têm nomes que excedem 400 caracteres ou contêm caracteres que o SharePoint bloqueia. O cliente de sincronização detecta o arquivo inválido, interrompe o processamento de toda a biblioteca e mostra pendente para todos os arquivos restantes.

Checklist do Administrador para Corrigir Sincronização Pendente de Biblioteca Compartilhada

Complete estas verificações na ordem listada. Não pule nenhuma etapa. Cada verificação aborda uma das causas raiz descritas acima.

Etapa 1: Verificar Permissões do Usuário na Biblioteca de Destino

1. Abra a central de administração do SharePoint
   Vá para Centros de administração > SharePoint. Selecione Sites ativos e encontre o site que contém a biblioteca migrada.
2. Verifique as permissões da biblioteca
   Selecione o site e escolha Permissões do site. Clique em Configurações avançadas de permissões. Confirme se o usuário ou seu grupo de segurança aparece na lista com pelo menos acesso de Leitura.
3. Teste o acesso em uma janela de navegador privada
   Abra o modo InPrivate ou Anônimo, faça login como o usuário afetado e navegue diretamente para a URL da biblioteca. Se o usuário vir um erro de acesso negado, adicione-o ao grupo de membros do site.

Etapa 2: Redefinir o Relacionamento de Sincronização para a Biblioteca Migrada

1. Pare a sincronização da biblioteca antiga
   No computador do usuário, clique com o botão direito no ícone do OneDrive na bandeja do sistema. Selecione Configurações > Conta. Em Escolher pastas, encontre o nome da biblioteca antiga e clique em Parar sincronização.
2. Remova os arquivos em cache do caminho antigo
   Abra o Explorador de Arquivos e navegue até C:\Usuários\[nome de usuário]\SharePoint. Exclua qualquer pasta que corresponda ao nome do site antigo. Não exclua arquivos das pastas Documentos ou Área de Trabalho do usuário.
3. Sincronize a nova biblioteca
   Em um navegador da web, abra a nova biblioteca. Clique no botão Sincronizar. Na caixa de diálogo, clique em Sincronizar agora. O cliente criará um novo relacionamento de sincronização com a URL correta.

Etapa 3: Executar o Solucionador de Problemas de Sincronização do OneDrive

1. Baixe e execute o Assistente de Suporte e Recuperação da Microsoft
   Vá para aka.ms/SaRA. Selecione OneDrive for Business e depois Problemas de sincronização. A ferramenta verifica violações de nomes de arquivo, erros de permissão e corrupção de metadados de sincronização.
2. Revise o relatório gerado
   Se a ferramenta encontrar nomes de arquivo bloqueados, anote os caminhos exatos dos arquivos. Renomeie esses arquivos no site do SharePoint para remover caracteres especiais ou encurtar o caminho para menos de 400 caracteres.

Etapa 4: Forçar uma Ressincronização Completa Usando Edição do Registro

1. Feche o OneDrive completamente
   Clique com o botão direito no ícone do OneDrive e selecione Sair do OneDrive. Confirme que nenhum processo OneDrive.exe permanece no Gerenciador de Tarefas.
2. Abra o Editor do Registro
   Pressione Windows + R, digite regedit e pressione Enter. Navegue até HKEY_CURRENT_USER\Software\Microsoft\OneDrive\Accounts\Business1.
3. Exclua os valores TenantId e SharePointUrl
   Clique com o botão direito em TenantId e escolha Excluir. Faça o mesmo para SharePointUrl. Feche o Editor do Registro.
4. Reinicie o OneDrive
   Pressione Windows + R, digite onedrive e pressione Enter. O cliente será reautenticado e reconstruirá o banco de dados de sincronização do zero.

Se o OneDrive Ainda Mostrar Pendente Após a Correção Principal

OneDrive mostra pendente apenas para tipos de arquivo específicos, como .pst ou .ost

Os arquivos de dados do Outlook são bloqueados por padrão em bibliotecas do SharePoint. Vá para Central de administração do SharePoint > Configurações > OneDrive > Sincronização. Em Bloquear sincronização de tipos de arquivo específicos, verifique se .pst ou .ost aparecem na lista. Remova essas entradas se sua migração exigir a sincronização desses arquivos.

Estado pendente aparece em uma biblioteca que foi sincronizada antes da migração

O token de sincronização antigo está em cache no banco de dados local do OneDrive do usuário. Use o comando Redefinir OneDrive. Abra uma caixa de diálogo Executar com Windows + R, digite onedrive.exe /reset e pressione Enter. Aguarde dois minutos. Se a sincronização não iniciar, digite onedrive.exe na mesma caixa de diálogo para reiniciar o cliente.

Vários usuários no mesmo departamento veem sincronização pendente ao mesmo tempo

Isso indica um problema no nível do locatário. Verifique o Centro de administração do Microsoft 365 > Integridade > Integridade do serviço. Procure pelo ID de aviso SP#### ou OD#### relacionado à migração do SharePoint ou sincronização do OneDrive. Se existir um incidente de serviço, aguarde a resolução antes de continuar. Não execute a redefinição do registro em todas as máquinas até que o incidente seja encerrado.

Métodos de Sincronização de Biblioteca Compartilhada Após a Migração: Comparação

Item	Parar e Ressincronizar	Redefinição do Registro
Descrição	Remove o relacionamento de sincronização antigo e adiciona a nova biblioteca	Exclui URLs de locatário e site em cache para forçar a reconstrução completa
Risco de perda de dados do usuário	Nenhum; os arquivos locais permanecem na pasta do SharePoint	Nenhum; apenas os metadados de sincronização são limpos
Tempo para concluir	5 a 10 minutos por máquina	2 a 5 minutos por máquina
Requer direitos de administrador	Não	Sim, para editar o registro
Melhor para	Migração de biblioteca única com um ou dois usuários	Migração em massa onde muitos usuários têm tokens desatualizados

Use o método parar e ressincronizar quando apenas alguns usuários forem afetados. Use o método de redefinição do registro quando a migração afetou um departamento inteiro e você precisar limpar tokens desatualizados em muitas máquinas rapidamente.

Agora você tem um checklist que cobre permissões, redefinição de relacionamento de sincronização, validação de nomes de arquivo e verificações de integridade no nível do locatário. Execute as verificações em ordem e teste a sincronização em um usuário piloto antes de implantar para todo o departamento. Para migrações futuras, ative a opção Preservar IDs de arquivo na Ferramenta de Migração do SharePoint (SPMT) para reduzir o número de estados de sincronização pendentes.