Solução de problemas de sincronização de bibliotecas compartilhadas do OneDrive for Business para bibliotecas grandes: loops após reinicialização

Após reiniciar o computador, o OneDrive for Business pode travar em um loop de sincronização ao sincronizar uma biblioteca compartilhada com milhares de arquivos ou pastas. A barra de progresso da sincronização passa por “Processando alterações” repetidamente sem concluir. Esse loop ocorre porque o mecanismo de sincronização tenta indexar e comparar todos os metadados de cada item da biblioteca toda vez que o aplicativo reinicia, e o tempo de processamento excede o limite interno de tempo limite. Este artigo explica por que bibliotecas compartilhadas grandes disparam esse loop de reinicialização e fornece um conjunto de correções direcionadas para quebrar o ciclo e restaurar a sincronização estável.

Por que o OneDrive entra em loop de sincronização após reiniciar com bibliotecas compartilhadas grandes

Ao reiniciar o Windows, o OneDrive precisa restabelecer a sincronização de cada biblioteca que gerencia. Para uma biblioteca de site pessoal ou de equipe padrão com menos de 5.000 itens, essa reindexação é concluída em segundos. Uma biblioteca compartilhada com 20.000 itens ou mais, especialmente uma que contenha pastas profundamente aninhadas ou muitas versões de arquivos, cria uma situação diferente.

A causa raiz técnica é a forma como o OneDrive lida com o estado “Processando alterações”. Após a reinicialização, o OneDrive realiza uma enumeração completa do banco de dados de sincronização local e o compara com os metadados do servidor. Para uma biblioteca grande, essa enumeração pode levar vários minutos. Durante esse tempo, o temporizador interno de verificação de integridade do OneDrive dispara uma reinicialização do mecanismo de sincronização se a enumeração não terminar dentro de uma janela predefinida. O mecanismo reinicia, começa a enumeração novamente e o ciclo se repete indefinidamente.

Arquivos sob Demanda piora o problema. Com Arquivos sob Demanda ativado, apenas arquivos de espaço reservado existem localmente. Após a reinicialização, o OneDrive precisa baixar novamente os metadados do espaço reservado para cada item antes de poder comparar os estados dos arquivos. Para uma biblioteca com 50.000 espaços reservados, esse download de metadados mais o processo de comparação quase sempre excede o limite de tempo, criando o loop.

Bibliotecas compartilhadas têm uma complicação adicional. O mecanismo de sincronização deve verificar as permissões de cada usuário que tem acesso à biblioteca. Uma biblioteca compartilhada com muitos membros ou herança de permissões complexa adiciona viagens de ida e volta extras ao servidor durante a fase de enumeração, atrasando ainda mais a conclusão e aumentando a chance de uma reinicialização acionada por tempo limite.

Etapas para interromper o loop de sincronização e restaurar a operação normal

Aplique estas etapas na ordem mostrada. Teste a sincronização após cada etapa para ver se o loop parou antes de passar para a próxima etapa.

1. Pausar e retomar a sincronização
   Clique com o botão direito no ícone do OneDrive na área de notificação. Selecione Pausar sincronização > 2 horas. Aguarde 30 segundos. Clique com o botão direito no ícone novamente e selecione Retomar sincronização. Isso redefine o mecanismo de sincronização sem uma reinicialização completa e às vezes interrompe um loop curto.
2. Desabilitar Arquivos sob Demanda para a biblioteca afetada
   Abra as configurações do OneDrive clicando com o botão direito no ícone do OneDrive e selecionando Configurações. Vá para a guia Sincronizar e fazer backup. Clique em Configurações avançadas. Em Arquivos sob Demanda, desative a opção. O OneDrive começará a baixar todos os arquivos da biblioteca compartilhada para o disco rígido local. Isso elimina o novo download de metadados de espaço reservado que dispara o loop após a reinicialização. Aguarde a conclusão do download antes de reiniciar o computador.
3. Parar a sincronização da biblioteca compartilhada e readicioná-la com pastas seletivas
   Nas configurações do OneDrive > Sincronizar e fazer backup > Gerenciar backup, clique em Parar sincronização ao lado da biblioteca compartilhada problemática. Confirme a parada. Abra o Explorador de Arquivos e navegue até a pasta local do OneDrive. Exclua a pasta dessa biblioteca. Reinicie o OneDrive clicando com o botão direito no ícone do OneDrive e selecionando Sair, e depois iniciando o OneDrive pelo menu Iniciar. Clique no ícone do OneDrive na área de notificação e selecione Adicionar conta. Faça login se solicitado. Quando a biblioteca compartilhada aparecer, clique no ícone de engrenagem e escolha apenas as subpastas que você precisa. Isso reduz a quantidade de itens que o OneDrive precisa indexar na reinicialização.
4. Aumentar o valor do registro para o tamanho máximo de download por lote
   Pressione a tecla Windows + R, digite regedit e pressione Enter. Navegue até HKEY_CURRENT_USER\Software\Microsoft\OneDrive\Accounts\Business1. Clique com o botão direito no painel direito, selecione Novo > Valor DWORD (32 bits). Nomeie como MaxDownloadSizeInMB. Clique duas vezes no novo valor, defina Base como Decimal e insira 2048. Clique em OK. Feche o Editor do Registro. Reinicie o OneDrive. Essa configuração permite que o OneDrive processe lotes maiores de arquivos durante a varredura inicial sem exceder o tempo limite.
5. Redefinir completamente a sincronização do OneDrive
   Pressione a tecla Windows + R, digite %localappdata%\Microsoft\OneDrive\onedrive.exe /reset e pressione Enter. Aguarde 60 segundos. Inicie o OneDrive pelo menu Iniciar. Faça login novamente. Readicione a biblioteca compartilhada usando a sincronização seletiva de pastas conforme descrito na etapa 3. Uma redefinição completa limpa o banco de dados de sincronização local, o que muitas vezes elimina a corrupção que contribui para o loop.

Se o OneDrive ainda entrar em loop após aplicar as principais correções

OneDrive mostra “Processando alterações” por mais de 10 minutos após cada reinicialização

Se o loop persistir após desabilitar Arquivos sob Demanda e aumentar o tamanho do lote do registro, a própria biblioteca compartilhada pode ter problemas estruturais. Peça ao administrador do site do SharePoint para verificar a biblioteca em busca de itens que excedam o limite de 250 caracteres no caminho do arquivo, arquivos com caracteres inválidos ou pastas com mais de 5.000 itens em uma única pasta. Essas condições forçam o OneDrive a realizar processamento adicional na reinicialização. O administrador pode usar o SharePoint Online Management Shell para executar Get-PnPFolder -List | Select-Object Name, ItemCount para identificar pastas superdimensionadas.

OneDrive para de sincronizar uma biblioteca compartilhada e exibe o código de erro 0x8007016a

O erro 0x8007016a indica que o caminho do arquivo local para a biblioteca sincronizada excedeu o comprimento máximo de 260 caracteres. Esse erro aparece comumente em bibliotecas grandes onde o aninhamento profundo de pastas ultrapassa o limite. Para corrigir, pare a sincronização da biblioteca, mova a pasta raiz do OneDrive para um caminho mais curto, como C:\OD, e readicione a biblioteca. Para alterar a pasta raiz do OneDrive, vá para Configurações do OneDrive > Sincronizar e fazer backup > Configurações avançadas > Gerenciar backup, pare toda a sincronização e, na mesma seção Configurações avançadas, clique em Mover pasta em Localização da pasta do OneDrive.

O loop de sincronização do OneDrive ocorre apenas em uma biblioteca compartilhada específica, mas não em outras

Isso aponta para uma configuração específica da biblioteca. A biblioteca pode ter o controle de versão ativado com um grande número de versões por arquivo. O OneDrive deve enumerar todas as versões durante a varredura de reinicialização. Peça ao administrador do site para reduzir o limite de contagem de versões nas configurações da biblioteca para 100 versões por arquivo. Vá para a biblioteca > ícone de engrenagem > Configurações da biblioteca > Configurações de controle de versão > defina Manter o seguinte número de versões principais como 100. Após a alteração, pare e readicione a biblioteca no OneDrive.

Arquivos sob Demanda vs Sincronização Local Completa para Bibliotecas Compartilhadas Grandes

Item	Arquivos sob Demanda Ativado	Sincronização Local Completa (Arquivos sob Demanda Desativado)
Espaço em disco local usado	Mínimo — apenas espaços reservados e arquivos em cache	Tamanho completo da biblioteca — todos os arquivos baixados
Tempo de reinicialização da sincronização após reinicialização	Longo — baixa novamente os metadados do espaço reservado para cada item	Curto — os arquivos locais já existem, então as comparações de metadados são mais rápidas
Risco de loop de sincronização após reinicialização	Alto para bibliotecas com mais de 5.000 itens	Baixo — o tempo limite é menos provável porque nenhum download de metadados é necessário
Disponibilidade de arquivos offline	Apenas arquivos marcados como Manter sempre neste dispositivo	Todos os arquivos disponíveis offline imediatamente
Uso de largura de banda na reinicialização	Baixo — apenas metadados são baixados	Alto — o download completo inicial usa largura de banda significativa

Para bibliotecas compartilhadas com mais de 10.000 arquivos, desabilitar Arquivos sob Demanda é a maneira mais confiável de evitar o loop de reinicialização. A compensação é maior uso de disco local e maior tempo de download inicial. Após a conclusão do download inicial, a sincronização incremental usa largura de banda mínima.

Agora você pode interromper o loop de sincronização do OneDrive após a reinicialização desabilitando Arquivos sob Demanda, readicionando a biblioteca com pastas seletivas ou aumentando o tamanho do lote do registro. Em seguida, verifique a biblioteca em busca de pastas superdimensionadas ou histórico de versões excessivo para evitar que o loop ocorra novamente. Para gerenciamento contínuo de bibliotecas grandes, considere usar o centro de administração do OneDrive para definir um número máximo de arquivos por biblioteca ou ativar relatórios de integridade de sincronização para detectar loops precocemente.