Sincronização de biblioteca compartilhada do OneDrive for Business fica pendente para equipes híbridas: Guia de correção

Quando membros de equipes híbridas sincronizam uma biblioteca compartilhada no OneDrive for Business, o status da sincronização pode ficar travado como Pendente por horas ou dias. Isso impede que os usuários vejam os arquivos mais recentes e bloqueia o acesso offline. A causa raiz geralmente é uma incompatibilidade entre a versão local do aplicativo de sincronização, o tamanho da biblioteca do SharePoint Online ou um proxy de rede que interfere no protocolo de sincronização. Este guia explica por que o estado Pendente ocorre e fornece uma correção estruturada para administradores de TI e usuários finais em ambientes de trabalho híbridos.

Por que a sincronização da biblioteca compartilhada do OneDrive fica travada como Pendente

O OneDrive for Business usa um mecanismo de sincronização dedicado que se comunica com o SharePoint Online por HTTPS. Quando uma biblioteca compartilhada é adicionada para sincronizar, o mecanismo primeiro enumera todos os arquivos e pastas nessa biblioteca. Se a biblioteca contiver mais de 100.000 itens ou arquivos individuais maiores que 250 GB, o processo de enumeração pode expirar e deixar a sincronização em um estado Pendente. O mecanismo de sincronização aguarda uma resposta do servidor que nunca é concluída.

As equipes híbridas adicionam outra camada de complexidade. Usuários que se conectam de uma rede corporativa por meio de VPN ou proxy podem sofrer perda de pacotes ou inspeção SSL que interrompe o protocolo de sincronização. O aplicativo de sincronização vê uma resposta parcial e marca a biblioteca como Pendente. Além disso, se o usuário tiver várias identidades armazenadas em cache no Gerenciador de Credenciais do Windows, o mecanismo de sincronização pode tentar a credencial errada e falhar silenciosamente.

Outra causa frequente é uma incompatibilidade entre a versão do aplicativo de sincronização do OneDrive e o locatário do SharePoint Online. A Microsoft atualiza o protocolo de sincronização regularmente. Se o aplicativo local estiver mais de duas versões desatualizado, o servidor pode rejeitar a solicitação de sincronização e enviar um status Pendente. O aplicativo de sincronização nem sempre exibe uma mensagem de erro nesse cenário.

Etapas para limpar o estado de sincronização Pendente em uma biblioteca compartilhada

As etapas a seguir se aplicam a dispositivos Windows 10 e Windows 11. Execute-as na ordem listada. Após cada etapa, verifique se o status Pendente muda para Sincronizando ou Atualizado.

1. Pausar e retomar a sincronização da biblioteca compartilhada
   Clique com o botão direito no ícone do OneDrive na bandeja do sistema. Selecione Ajuda e Configurações > Pausar sincronização > 2 horas. Aguarde 30 segundos, clique com o botão direito novamente e selecione Retomar sincronização. Isso força o mecanismo de sincronização a tentar novamente a enumeração da biblioteca sem reiniciar o aplicativo.
2. Remover e adicionar novamente a biblioteca compartilhada da sincronização
   Clique com o botão direito no ícone do OneDrive e selecione Configurações. Vá para a guia Conta. Em Bibliotecas compartilhadas, localize a biblioteca que mostra Pendente. Clique em Parar sincronização. Confirme a ação. Em seguida, clique em Adicionar uma biblioteca compartilhada, pesquise a mesma biblioteca e selecione Sincronizar. Isso cria um novo token de sincronização e limpa qualquer estado local corrompido.
3. Limpar credenciais em cache do OneDrive do Gerenciador de Credenciais do Windows
   Abra o Painel de Controle e selecione Gerenciador de Credenciais. Clique em Credenciais do Windows. Role até a seção Credenciais Genéricas. Procure por entradas que começam com OneDrive Cached Credential ou MicrosoftOffice15_Data:ADAL:. Clique na seta para expandir cada entrada e selecione Remover. Reinicie o OneDrive. O aplicativo solicitará as credenciais novamente na próxima tentativa de sincronização.
4. Redefinir o aplicativo de sincronização do OneDrive
   Pressione a tecla Windows + R, digite onedrive.exe /reset e pressione Enter. Aguarde a janela de configuração do OneDrive reaparecer. Faça login novamente com a mesma conta corporativa ou de estudante. Após a redefinição, adicione novamente a biblioteca compartilhada na guia Conta. A redefinição limpa todos os metadados de sincronização em cache, mas não exclui arquivos locais.
5. Desabilitar proxy ou VPN temporariamente para teste
   Se o usuário se conectar por meio de uma VPN corporativa, desconecte-a. Abra Configurações do Windows > Rede e Internet > Proxy. Desative Usar um servidor proxy. Reinicie o OneDrive e verifique o status da sincronização. Se a biblioteca começar a sincronizar, o proxy ou VPN está interferindo. Adicione os endpoints do OneDrive à lista de permissões no firewall ou na configuração do proxy.
6. Atualizar o aplicativo de sincronização do OneDrive para a versão mais recente
   Clique com o botão direito no ícone do OneDrive e selecione Configurações. Vá para a guia Sobre. Anote o número da compilação. Abra um navegador e acesse a página de notas de versão do OneDrive. Compare a compilação com a versão de produção mais recente. Se a versão local for mais antiga, baixe o instalador mais recente do OneDrive no centro de administração do Microsoft 365 e execute-o. Reinicie o dispositivo após a atualização.

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

Biblioteca compartilhada do OneDrive Pendente após readicionar a biblioteca

Se a biblioteca permanecer Pendente após seguir as etapas acima, verifique o tamanho da biblioteca do SharePoint Online. Abra um navegador e navegue até a biblioteca. Na parte inferior da página, procure o número total de itens. Se a biblioteca tiver mais de 100.000 itens, o mecanismo de sincronização pode levar várias horas para enumerar. Use o botão Sincronizar no navegador em vez do aplicativo OneDrive para iniciar uma nova sincronização. Se a contagem exceder 500.000 itens, divida a biblioteca em pastas menores e sincronize cada pasta separadamente.

OneDrive mostra Pendente para todas as bibliotecas compartilhadas, mas a biblioteca pessoal funciona

Esse padrão indica um problema de permissões no conjunto de sites do SharePoint. O usuário pode ter sido removido do grupo de membros do site, mas ainda tem uma relação de sincronização em cache. Peça ao administrador do SharePoint para verificar as permissões do usuário no conjunto de sites. Se o usuário estiver listado como visitante ou não tiver permissões explícitas, remova a biblioteca da sincronização do OneDrive e adicione-a novamente após o administrador conceder pelo menos acesso de nível Editar.

OneDrive Pendente na rede doméstica de um membro da equipe híbrida, mas funciona no escritório

Diferenças na configuração de rede causam esse comportamento. A rede doméstica pode ter um roteador que bloqueia conexões WebSocket, que o OneDrive usa para sincronização em tempo real. Peça ao usuário para abrir um prompt de comando e executar nslookup config.office.com. Se a consulta falhar ou retornar um endereço IP que não seja da Microsoft, o resolvedor DNS está mal configurado. Altere o servidor DNS para 8.8.8.8 temporariamente e teste a sincronização novamente.

Arquivos Sob Demanda vs Manter Sempre Neste Dispositivo: Impacto na Sincronização Pendente

Item	Arquivos Sob Demanda	Manter Sempre Neste Dispositivo
Descrição	Arquivos placeholder são baixados apenas quando abertos	Todos os arquivos na pasta são baixados e mantidos offline
Impacto no estado Pendente	Reduz o tempo de enumeração para bibliotecas grandes porque os metadados são buscados primeiro	Aumenta o tempo de enumeração porque o mecanismo deve baixar o cabeçalho de cada arquivo
Recomendado para equipes híbridas	Sim, especialmente para bibliotecas com mais de 10.000 itens	Não, a menos que o usuário precise de todos os arquivos offline e tenha uma conexão rápida
Como alternar	Clique com o botão direito na pasta da biblioteca compartilhada no Explorador de Arquivos > Manter sempre neste dispositivo para desativar	Clique com o botão direito na pasta da biblioteca compartilhada > Manter sempre neste dispositivo para ativar

Para equipes híbridas, Arquivos Sob Demanda é a melhor escolha. Isso impede que o mecanismo de sincronização tente baixar todos os arquivos durante a enumeração inicial, que é o gatilho mais comum para o estado Pendente. Os usuários ainda podem marcar pastas individuais como Manter sempre neste dispositivo se precisarem de acesso offline a arquivos de projeto específicos.

Após aplicar as correções neste guia, a biblioteca compartilhada deve passar de Pendente para Sincronizando em 15 minutos. Se o status não mudar, execute o solucionador de problemas de sincronização do OneDrive integrado ao Windows 11 pesquisando por Localizar e corrigir problemas com o OneDrive no aplicativo Configurações. Como etapa avançada, os administradores de TI podem usar o SharePoint Online Management Shell para executar Set-SPOSite -Identity -StorageQuota para aumentar o limite de armazenamento da biblioteca se o estado Pendente for causado por esgotamento da cota.