Solução de sincronização de biblioteca compartilhada do OneDrive for Business para equipes híbridas: fica pendente

Quando você sincroniza uma biblioteca compartilhada no OneDrive for Business, o status de sincronização pode permanecer como “Processando alterações” ou mostrar um estado pendente por horas. Esse problema afeta equipes híbridas onde alguns membros trabalham localmente e outros na nuvem. A causa raiz geralmente é uma incompatibilidade entre as versões locais dos arquivos e os metadados do servidor, combinada com o comportamento de limitação do OneDrive para bibliotecas compartilhadas grandes. Este artigo explica por que o estado pendente ocorre e fornece um método passo a passo para forçar a conclusão da sincronização.

Por que a sincronização da biblioteca compartilhada fica pendente para equipes híbridas

As bibliotecas compartilhadas do OneDrive for Business são baseadas no SharePoint Online. Quando um usuário sincroniza uma biblioteca, o mecanismo de sincronização do OneDrive compara os metadados locais dos arquivos com os metadados do servidor SharePoint. Para equipes híbridas, os metadados incluem histórico de versões, bloqueios de coautoria e alterações de propriedades de arquivos que ocorrem tanto localmente quanto na nuvem.

O estado pendente ocorre quando o OneDrive não consegue resolver conflitos entre o cache local e o servidor. Isso acontece comumente quando:

• A biblioteca tem mais de 5.000 itens. O SharePoint limita solicitações para bibliotecas acima desse limite, fazendo com que o OneDrive pause a sincronização.
• Os limites do histórico de versões são altos. Cada versão armazena metadados que o OneDrive precisa processar. Bibliotecas com 500 versões por arquivo criam uma carga pesada de sincronização.
• Os bloqueios de arquivos da coautoria não são liberados corretamente. Se um membro da equipe híbrida editar um arquivo em um servidor local e o mesmo arquivo for editado no SharePoint Online, o estado do bloqueio pode se tornar ambíguo.
• O OneDrive está configurado com o comportamento de limitação padrão. O mecanismo de sincronização reduz sua taxa de consulta quando detecta alta rotatividade, o que faz o estado pendente durar mais tempo.

O mecanismo de sincronização usa um arquivo chamado banco de dados de sincronização para rastrear alterações. Quando o banco de dados cresce devido a muitas alterações pendentes, o processo de sincronização entra em um loop de reavaliação de metadados sem concluir a sincronização. É por isso que o status mostra “Processando alterações” indefinidamente.

Passos para forçar a conclusão da sincronização da biblioteca compartilhada

Estes passos resolvem o estado pendente sem excluir seus arquivos locais ou quebrar a relação de sincronização. Execute-os na ordem mostrada.

1. Pare o processo de sincronização do OneDrive
   Clique com o botão direito no ícone do OneDrive na bandeja do sistema. Selecione Pausar sincronização e escolha 2 horas. Aguarde 30 segundos. Isso interrompe o mecanismo de sincronização de processar novas alterações enquanto você prepara a correção.
2. Remova a sincronização da biblioteca compartilhada
   Abra as configurações do OneDrive clicando no ícone do OneDrive na bandeja do sistema, depois no ícone de engrenagem e em Configurações. Vá para a guia Conta. Em Gerenciar as pastas sincronizadas neste computador, encontre a biblioteca compartilhada que está travada. Clique em Parar sincronização. Confirme o prompt. Isso remove a relação de sincronização, mas não exclui a cópia local dos arquivos.
3. Feche o OneDrive completamente
   Clique com o botão direito no ícone do OneDrive na bandeja do sistema e selecione Sair. Abra o Gerenciador de Tarefas pressionando Ctrl + Shift + Escape. Na guia Processos, procure por processos OneDrive.exe restantes. Selecione cada um e clique em Finalizar tarefa. Aguarde 10 segundos.
4. Limpe o cache de sincronização do OneDrive
   Pressione Win + R, digite %localappdata%\Microsoft\OneDrive\settings\Business1 e pressione Enter. Exclua todos os arquivos nesta pasta. Não exclua a pasta em si. Isso remove os metadados em cache que causam o loop pendente. Os arquivos serão ressincronizados do SharePoint.
5. Reinicie o OneDrive e ressincronize a biblioteca
   Abra o menu Iniciar, digite OneDrive e pressione Enter. Faça login se solicitado. Após o OneDrive iniciar, clique no ícone do OneDrive na bandeja do sistema, selecione o ícone de engrenagem e escolha Configurações. Vá para a guia Conta. Clique em Adicionar uma conta ou Escolher pastas. Navegue até a biblioteca compartilhada e marque a caixa ao lado dela. Clique em Iniciar sincronização. O OneDrive reconstruirá o banco de dados de sincronização e começará a sincronizar.
6. Monitore o status da sincronização
   Passe o mouse sobre o ícone do OneDrive na bandeja do sistema. O status deve mudar de Processando alterações para Atualizado em até 15 minutos para bibliotecas com menos de 5.000 itens. Para bibliotecas maiores, aguarde até 2 horas. Se o status pendente retornar, repita os passos 1 a 3 e prossiga para a próxima seção.

Se o OneDrive ainda mostrar pendente após a correção principal

A sincronização do OneDrive está travada em “Processando alterações” após readicionar a biblioteca

Isso indica que a reconstrução do cache de sincronização está falhando devido a um arquivo local corrompido. Abra a pasta sincronizada no Explorador de Arquivos. Procure por arquivos com um ícone de sobreposição X vermelho. Renomeie ou exclua esses arquivos. Em seguida, reinicie o OneDrive usando os passos acima. O mecanismo de sincronização baixará cópias novas do SharePoint.

A biblioteca compartilhada tem mais de 20.000 itens

O SharePoint Online tem um limite de sincronização de 20.000 itens por biblioteca. Se a biblioteca exceder esse número, o OneDrive não sincronizará a biblioteca inteira. Peça ao proprietário do site para dividir a biblioteca em várias bibliotecas com menos itens. Como alternativa, use o recurso Adicionar atalho ao OneDrive em vez de sincronizar. Isso cria um link da web que abre a biblioteca no navegador sem sincronizar arquivos localmente.

Membros da equipe híbrida veem versões diferentes de arquivos após a sincronização

Isso é causado por conflitos de versão entre cópias locais e na nuvem. Instrua todos os membros da equipe a usar o mesmo método de sincronização. Se alguns usuários sincronizam via OneDrive e outros acessam arquivos através de uma unidade mapeada para um servidor local, as incompatibilidades de versão são inevitáveis. Mova todos os arquivos para o SharePoint Online e remova as unidades mapeadas locais. Em seguida, execute os passos da correção principal acima em cada máquina.

OneDrive mostra “Pendente” para uma biblioteca que funcionava antes

Uma atualização recente do OneDrive pode ter alterado o comportamento de sincronização. Verifique a versão do OneDrive clicando com o botão direito no ícone do OneDrive na bandeja do sistema, selecionando Configurações e depois a guia Sobre. Se a versão for anterior a 24.001.0129.0001, baixe a versão mais recente do centro de administração do Microsoft 365. Após a atualização, repita os passos da correção principal.

Métodos de sincronização para bibliotecas compartilhadas: OneDrive vs Botão de sincronização do SharePoint vs Adicionar atalho

Item	Cliente de Sincronização do OneDrive	Botão de Sincronização do SharePoint	Adicionar Atalho ao OneDrive
Como funciona	Baixa arquivos para a pasta local do OneDrive e sincroniza alterações bidirecionalmente	Abre a biblioteca no Explorador de Arquivos através de uma sincronização baseada na web iniciada no SharePoint	Cria um atalho da web na pasta do OneDrive que abre a biblioteca no navegador
Acesso offline	Acesso offline completo a todos os arquivos sincronizados	Acesso offline completo apenas se os arquivos estiverem marcados como “Manter sempre neste dispositivo”	Sem acesso offline. Os arquivos abrem no navegador
Melhor para	Usuários que precisam de acesso offline e trabalham com menos de 20.000 itens	Usuários que precisam de acesso offline para arquivos específicos em bibliotecas grandes	Usuários que raramente precisam de acesso offline e querem evitar a sobrecarga de sincronização
Problemas de sincronização pendente	Mais comum. Causado por conflitos de metadados, grande número de itens ou histórico de versões	Menos comum porque a sincronização é acionada sob demanda a partir do SharePoint	Nenhum problema de sincronização pendente porque nenhum arquivo é baixado

Agora você pode forçar a conclusão de uma sincronização de biblioteca compartilhada travada limpando o cache de sincronização e readicionando a biblioteca. Em seguida, revise as configurações de histórico de versões na sua biblioteca do SharePoint. Defina o limite de versões para 100 para evitar futuros estados pendentes. Para equipes híbridas, garanta que todos os membros usem exclusivamente o cliente de sincronização do OneDrive, em vez de misturar unidades mapeadas locais.