Sincronização de biblioteca compartilhada do OneDrive for Business fica pendente em bibliotecas grandes: Guia de correção

Quando você sincroniza uma biblioteca de documentos compartilhada no OneDrive for Business, o status da sincronização pode permanecer travado como “Pendente” por horas ou até dias. Esse problema ocorre com mais frequência em bibliotecas com mais de 5.000 arquivos ou 20.000 itens no total. A causa raiz é uma combinação dos limites internos do índice de arquivos do OneDrive e a forma como as bibliotecas compartilhadas sincronizam metadados de maneira diferente das pastas pessoais do OneDrive. Este artigo explica por que bibliotecas compartilhadas grandes travam durante a sincronização e fornece etapas estruturadas para resolver o estado pendente, permitindo que você acesse seus arquivos localmente.

Por que a sincronização do OneDrive fica travada como pendente em bibliotecas compartilhadas grandes

O OneDrive for Business sincroniza bibliotecas compartilhadas usando o mesmo mecanismo de sincronização que lida com pastas pessoais do OneDrive. No entanto, as bibliotecas compartilhadas no SharePoint Online têm uma estrutura de metadados diferente. Quando você adiciona uma sincronização para uma biblioteca compartilhada, o OneDrive precisa baixar um índice completo de arquivos antes de começar a copiar os arquivos. Para bibliotecas com mais de 20.000 itens, o tamanho do índice excede 50 MB. O mecanismo de sincronização pode expirar ao processar esse índice, deixando o status permanentemente como “Pendente”.

Uma causa secundária é a falta de colunas indexadas na biblioteca. O SharePoint usa colunas padrão como ID, FileLeafRef e Modified. Quando uma biblioteca tem colunas personalizadas usadas em exibições ou classificação sem indexação, o mecanismo de sincronização precisa escanear toda a biblioteca para resolver os metadados dos arquivos. Essa operação de escaneamento pode levar várias horas para bibliotecas com mais de 10.000 arquivos. Durante esse tempo, o OneDrive mostra “Pendente” porque ainda não recebeu a lista completa de arquivos do servidor.

Um terceiro fator é o limite de sincronização do OneDrive de 5.000 arquivos por pasta. Se a biblioteca compartilhada tiver uma pasta contendo mais de 5.000 arquivos, o mecanismo de sincronização não consegue processar essa pasta. Ele deixa toda a biblioteca em estado pendente em vez de mostrar um erro de sincronização parcial. Esse comportamento é proposital para evitar corrupção de dados, mas engana os usuários fazendo-os pensar que toda a sincronização está travada.

Etapas para limpar uma sincronização pendente em uma biblioteca compartilhada grande

Antes de começar, confirme se o tamanho da biblioteca é a causa. Abra a biblioteca do SharePoint em um navegador. Na parte inferior da página, veja a contagem de itens. Se exceder 20.000 itens, prossiga com as etapas abaixo. Se a contagem for menor, a causa pode ser um problema de rede ou um cache local corrompido. Essas etapas se aplicam ao Windows 11 e Windows 10.

1. Pare a sincronização da biblioteca compartilhada
   Clique com o botão direito no ícone do OneDrive na bandeja do sistema e selecione Configurações. Vá para a guia Sincronizar e fazer backup. Clique em Gerenciar backup. Encontre a biblioteca compartilhada na lista e clique em Parar backup. Confirme a ação. Isso remove a relação de sincronização sem excluir seus arquivos locais.
2. Limpe o cache de sincronização do OneDrive
   Pressione a tecla Windows + R, digite %localappdata%\Microsoft\OneDrive\settings e pressione Enter. Feche o OneDrive pela bandeja do sistema. Exclua todos os arquivos e pastas dentro do diretório settings, exceto as pastas Personal e Business. Reinicie o OneDrive. Isso força um download novo de metadados quando você adicionar a biblioteca novamente.
3. Adicione colunas indexadas à biblioteca compartilhada
   No navegador, vá para a biblioteca do SharePoint. Clique no ícone de engrenagem e selecione Configurações da biblioteca. Em Colunas, clique em Criar coluna. Adicione colunas indexadas para quaisquer colunas personalizadas usadas nas exibições da sua biblioteca. Por exemplo, se você classificar por Departamento, crie uma coluna Departamento e defina Indexado como Sim. Repita para colunas usadas em filtros. Isso reduz o tempo de consulta do mecanismo de sincronização.
4. Readicione a biblioteca compartilhada para sincronização
   Abra as Configurações do OneDrive novamente. Vá para a guia Sincronizar e fazer backup. Clique em Gerenciar backup. Clique em Adicionar uma pasta. Navegue até a biblioteca compartilhada na lista de sites do SharePoint. Selecione a biblioteca e clique em Sincronizar. O OneDrive começará a sincronizar com um índice novo. O status pendente deve mudar para sincronizando em até 10 minutos para bibliotecas com menos de 30.000 itens.
5. Monitore o progresso da sincronização
   Clique no ícone do OneDrive na bandeja do sistema para abrir o painel de atividade de sincronização. Procure pelo nome da biblioteca. Se mostrar “Processando alterações” por mais de 30 minutos, prossiga para a próxima seção para correções adicionais.

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

OneDrive mostra pendente por mais de 2 horas

Se o status pendente persistir por mais de 2 horas após concluir as etapas acima, a biblioteca provavelmente excede o limite de sincronização de 100.000 itens. O OneDrive não pode sincronizar uma biblioteca com mais de 100.000 itens em nenhuma configuração. A única solução é reduzir o tamanho da biblioteca. Mova arquivos mais antigos para uma biblioteca de arquivo morto ou crie bibliotecas separadas para diferentes departamentos. Após reduzir a contagem de itens para abaixo de 100.000, repita as etapas da seção anterior.

OneDrive sincroniza algumas pastas, mas não outras na mesma biblioteca

Isso ocorre quando uma subpasta na biblioteca contém mais de 5.000 arquivos. O OneDrive pula a pasta muito grande e deixa a biblioteca pai em estado pendente. Para corrigir, abra a biblioteca do SharePoint em um navegador. Navegue até a pasta grande. Mova arquivos para subpastas de modo que nenhuma pasta contenha mais de 5.000 itens. Após reorganizar, clique com o botão direito no ícone do OneDrive e selecione Retomar sincronização. O status pendente deve desaparecer em até 30 minutos.

Erro de sincronização do OneDrive 0x8007017C em bibliotecas grandes

O erro 0x8007017C significa que o caminho do arquivo excede 400 caracteres. Quando uma biblioteca compartilhada tem estruturas de pastas profundas, o caminho combinado de “nome do site do SharePoint” + “nome da biblioteca” + “caminho da pasta” + “nome do arquivo” pode exceder o limite de caminho do Windows. O OneDrive mostra pendente enquanto tenta processar esses arquivos. Para corrigir, encurte os nomes das pastas na biblioteca. Use abreviações ou remova níveis desnecessários. Após encurtar os caminhos, reinicie o OneDrive pelo menu da bandeja do sistema.

Limites de sincronização do OneDrive vs limites da biblioteca do SharePoint: Principais diferenças

Item	Sincronização do OneDrive for Business	Biblioteca do SharePoint Online
Máximo de itens totais por biblioteca	100.000 itens	30 milhões de itens
Máximo de arquivos por pasta	5.000 arquivos	30.000 arquivos por exibição
Tamanho máximo de arquivo	15 GB	250 GB
Tempo limite do índice de sincronização	30 segundos por 1.000 itens	Sem tempo limite

Os limites de sincronização do OneDrive são muito mais rigorosos do que os limites da biblioteca do SharePoint Online. Uma biblioteca que funciona perfeitamente no navegador pode falhar ao sincronizar. Sempre verifique a contagem de itens e a estrutura de pastas antes de sincronizar uma biblioteca compartilhada.

Após concluir as etapas acima, você pode sincronizar bibliotecas compartilhadas grandes sem o status pendente. Se o problema retornar, verifique a contagem de itens da biblioteca mensalmente e arquive conteúdo antigo. Para bibliotecas com mais de 50.000 itens, considere usar o aplicativo móvel do SharePoint em vez de sincronizar. Uma dica avançada: use fluxos do Power Automate do SharePoint para mover arquivos com mais de 90 dias para uma biblioteca de arquivo morto automaticamente. Isso mantém sua biblioteca sincronizada abaixo do limite de 5.000 arquivos por pasta.