Solução de problemas de sincronização de biblioteca compartilhada do OneDrive for Business em redes lentas: fica como Pendente

Ao adicionar uma biblioteca compartilhada no OneDrive for Business, o status de sincronização pode ficar travado como “Pendente” por horas, especialmente em redes lentas ou de alta latência. Esse sintoma significa que o OneDrive não consegue concluir o download inicial de metadados ou a enumeração de arquivos do site do SharePoint ou Teams. A causa raiz geralmente é uma combinação de limitação de rede, tamanho grande da biblioteca e o comportamento de tempo limite do OneDrive para solicitações de metadados. Este artigo explica por que as bibliotecas compartilhadas ficam travadas no estado pendente em conexões lentas e fornece um conjunto de correções para fazê-las sincronizar novamente.

Por que uma biblioteca compartilhada fica pendente em uma rede lenta

Ao adicionar uma biblioteca compartilhada do SharePoint ou Teams ao OneDrive, o aplicativo de sincronização deve primeiro baixar os metadados da biblioteca — uma lista de todos os arquivos, pastas, permissões e histórico de versões. Em uma rede lenta, esse download de metadados pode exceder o tempo limite interno do OneDrive, fazendo com que o status mostre “Pendente” indefinidamente. O mecanismo de sincronização usa um padrão de solicitação sequencial: ele envia uma solicitação de metadados, aguarda uma resposta e, se a resposta for atrasada ou descartada, todo o processo de sincronização para.

Vários fatores pioram esse comportamento:

Tamanho e profundidade da biblioteca

Bibliotecas com milhares de arquivos, hierarquias de pastas profundas ou muitas subpastas aninhadas geram grandes cargas de metadados. Em uma conexão lenta, baixar essa carga pode levar minutos, e o OneDrive pode interpretar o atraso como uma falha.

Latência de rede e perda de pacotes

Alta latência — acima de 150 ms de tempo de ida e volta — aumenta o tempo para cada ciclo de solicitação-resposta de metadados. A perda de pacotes causa retransmissões, estendendo ainda mais o tempo total. O serviço de sincronização do OneDrive tem um tempo limite padrão de cerca de 60 segundos por solicitação. Se o download de metadados não for concluído dentro desse período, a solicitação é repetida e o status permanece pendente.

Interação do Files On-Demand

O Files On-Demand exige que o aplicativo de sincronização mantenha uma conexão constante com a nuvem para buscar metadados de espaço reservado. Em uma rede lenta, essa conexão pode cair, fazendo com que o status pendente persista até que a conexão seja restabelecida.

Etapas para resolver a sincronização pendente de bibliotecas compartilhadas em redes lentas

Use os seguintes métodos em ordem. Comece com a correção menos invasiva e escale somente se o problema persistir.

1. Pausar e retomar a sincronização
   Clique com o botão direito no ícone do OneDrive na bandeja do sistema. Selecione Pausar sincronização e escolha uma duração, como 2 horas. Após o término da pausa, o OneDrive retoma automaticamente. Isso força o mecanismo de sincronização a reinicializar a solicitação de metadados do zero. Se o status pendente for limpo, a solicitação original havia expirado e uma nova solicitação foi bem-sucedida em um link menos congestionado.
2. Definir um limite de taxa de download
   Clique com o botão direito no ícone do OneDrive e selecione Configurações. Vá para a guia Rede. Em Limite de taxa de download, marque Limitar taxa de download e defina um valor entre 500 KB/s e 2 MB/s. Clique em OK. Limitar a velocidade de download impede que o OneDrive envie rajadas de solicitações que podem acionar timeouts em links lentos. Após alterar essa configuração, reinicie o OneDrive pelo menu da bandeja do sistema.
3. Remover e adicionar novamente a biblioteca compartilhada
   Clique com o botão direito no ícone do OneDrive e selecione Configurações. Vá para Sincronizar e fazer backup > Gerenciar backup. Em Bibliotecas compartilhadas, clique em Parar sincronização ao lado da biblioteca travada. Aguarde 30 segundos. Em seguida, clique em Adicionar uma biblioteca compartilhada, selecione a mesma biblioteca e clique em Adicionar. Isso limpa os metadados locais corrompidos e força um download limpo. Em uma rede lenta, essa etapa geralmente resolve o status pendente.
4. Desativar o Files On-Demand para a biblioteca
   Abra o Explorador de Arquivos. Navegue até a pasta da biblioteca compartilhada. Clique com o botão direito na pasta e selecione Manter sempre neste dispositivo. Isso força o OneDrive a baixar todos os arquivos localmente. Embora use mais espaço em disco, remove a dependência de solicitações constantes de metadados. Aguarde a conclusão do download. O status pendente deve mudar para uma marca de seleção verde assim que todos os arquivos forem sincronizados.
5. Aumentar o tempo limite de aceleração da sincronização via Registro
   Pressione Win + R, digite regedit e pressione Enter. Navegue até HKEY_CURRENT_USER\Software\Microsoft\OneDrive. Clique com o botão direito no painel direito, selecione Novo > Valor DWORD (32 bits) e nomeie como ThrottleTimeoutMs. Defina o valor como 120000 decimal (120 segundos). Clique em OK. Reinicie o OneDrive. Isso aumenta o tempo limite da solicitação de metadados de 60 segundos para 120 segundos, dando mais tempo para redes lentas responderem. Use isso apenas se as etapas anteriores falharem.

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

OneDrive mostra pendente apenas em uma biblioteca compartilhada, mas outras sincronizam normalmente

A biblioteca problemática provavelmente tem um número muito grande de arquivos ou uma estrutura de pastas profunda. Abra a biblioteca em um navegador e verifique a contagem de itens na página de configurações da biblioteca. Se a biblioteca exceder 30.000 itens, divida-a em bibliotecas menores usando ferramentas de gerenciamento de conteúdo do SharePoint. Em seguida, remova e adicione novamente cada biblioteca menor ao OneDrive.

O mecanismo de sincronização do OneDrive trava ou congela durante o download de metadados

Arquivos em cache corrompidos podem fazer o mecanismo de sincronização travar. Saia completamente do OneDrive clicando com o botão direito no ícone da bandeja do sistema e selecionando Sair do OneDrive. Abra o Explorador de Arquivos e navegue até %localappdata%\Microsoft\OneDrive. Exclua a pasta settings. Reinicie o OneDrive e faça login novamente. Isso redefine todos os metadados em cache e força uma nova sincronização completa.

Proxy de rede ou firewall bloqueia solicitações de metadados

Proxies corporativos ou firewalls às vezes bloqueiam as URLs específicas que o OneDrive usa para metadados de bibliotecas compartilhadas. Verifique se as seguintes URLs são permitidas: onedrive.live.com e todos os subdomínios, sharepoint.com e todos os subdomínios, e files.1drv.com e todos os subdomínios. Entre em contato com o administrador da rede para confirmar que elas não estão filtradas. Após desbloquear, reinicie o OneDrive.

Files On-Demand vs Manter Sempre Neste Dispositivo: Principais Diferenças para Bibliotecas Compartilhadas

Item	Files On-Demand	Manter Sempre Neste Dispositivo
Descrição	Apenas espaços reservados; arquivos baixados sob demanda	Todos os arquivos baixados e armazenados localmente
Dependência de rede	Requer conexão constante para metadados	Requer apenas download inicial
Uso de espaço em disco	Mínimo	Tamanho total dos arquivos
Melhor para redes lentas	Não recomendado — status pendente comum	Recomendado — evita timeouts de metadados
Velocidade de sincronização após download inicial	Mais lenta para cada acesso a arquivo	Mais rápida para acesso local a arquivos

Em uma rede lenta, Manter Sempre Neste Dispositivo é a escolha mais confiável para bibliotecas compartilhadas. Elimina a sobrecarga de solicitação de metadados que causa o status pendente. Volte para Files On-Demand somente após a conexão de rede melhorar.

Agora você pode resolver uma biblioteca compartilhada travada como pendente limitando a velocidade de download, removendo e adicionando novamente a biblioteca ou desativando o Files On-Demand. Comece com a configuração de limite de taxa de download nas preferências do OneDrive — ela não requer exclusão de arquivos e preserva o estado de sincronização. Se o problema se repetir, considere dividir bibliotecas grandes em unidades menores. Como dica avançada, use o valor ThrottleTimeoutMs baseado no Registro para dar às conexões lentas até 120 segundos por solicitação de metadados, o que geralmente resolve o status pendente persistente sem remover a biblioteca.