Sincronização de biblioteca compartilhada do OneDrive for Business fica pendente no Mac: Guia de correção

Quando você adiciona uma biblioteca compartilhada no OneDrive for Business no seu Mac, o status de sincronização frequentemente mostra “Pendente” e nunca é concluído. Isso impede o acesso offline aos arquivos da biblioteca e pode bloquear atualizações de outros membros da equipe. A causa raiz geralmente é um conflito entre o cache local do OneDrive e os metadados da biblioteca compartilhada, muitas vezes desencadeado por permissões do macOS ou credenciais desatualizadas. Este guia explica por que o estado pendente ocorre e fornece quatro métodos comprovados para restaurar a sincronização completa.

Por que a sincronização de biblioteca compartilhada do OneDrive fica travada como Pendente no Mac

O OneDrive for Business usa uma pasta de cache local em ~/Library/CloudStorage/ para armazenar arquivos sincronizados. Quando você adiciona uma biblioteca compartilhada, o OneDrive precisa baixar os metadados e a estrutura de arquivos da biblioteca para esse cache. Se o cache já contiver metadados desatualizados ou conflitantes de uma sincronização anterior, o OneDrive não consegue concluir o download inicial e mostra “Pendente” indefinidamente.

Os controles de privacidade do macOS complicam ainda mais isso. A partir do macOS Catalina, os aplicativos precisam de permissão explícita para acessar arquivos em determinadas pastas. Se o OneDrive não tiver acesso total ao disco ou se a pasta de cache tiver permissões incorretas, o mecanismo de sincronização não consegue gravar novos dados e permanece em estado pendente.

Uma segunda causa comum é um token OAuth expirado ou revogado. O OneDrive for Business autentica usando tokens do Azure Active Directory armazenados no Keychain do macOS. Se o token expirou porque o usuário alterou a senha, ou se o token foi revogado por uma política de administrador, o OneDrive não consegue validar a associação à biblioteca compartilhada e fica pendente.

Métodos para corrigir a sincronização pendente de biblioteca compartilhada do OneDrive no Mac

Cada método abaixo tem como alvo uma causa raiz específica. Comece com o Método 1, pois ele resolve a maioria dos problemas de sincronização pendente sem afetar outras configurações.

Método 1: Desvincular e vincular novamente o OneDrive no Mac

Desvincular remove o cache local e força o OneDrive a reconstruir seus metadados do zero. Isso limpa quaisquer arquivos de cache corrompidos que causam o estado pendente.

1. Abra as Preferências do OneDrive
   Clique no ícone de nuvem do OneDrive na barra de menus. Clique no ícone de engrenagem e selecione Preferências.
2. Vá para a guia Conta
   Na janela de Preferências, clique na guia Conta no topo.
3. Desvincular este Mac
   Abaixo do nome da sua conta, clique em Desvincular este Mac. Confirme a ação quando solicitado. O OneDrive fechará automaticamente.
4. Reinicie o OneDrive e faça login novamente
   Abra o OneDrive na pasta Aplicativos. Faça login com sua conta corporativa ou de estudante. Após o login, vá em Preferências > Conta e clique em Adicionar uma biblioteca compartilhada. Adicione novamente a biblioteca que estava pendente.

Método 2: Limpar credenciais do OneDrive do Keychain

Se o estado pendente persistir após desvincular, o token OAuth armazenado pode estar inválido. Excluí-lo força o OneDrive a solicitar um novo token.

1. Abra o Keychain Access
   Abra Finder > Aplicativos > Utilitários > Keychain Access.
2. Pesquise por entradas do OneDrive
   No campo de pesquisa, digite OneDrive. Uma lista de itens aparece, incluindo entradas chamadas OneDrive, Microsoft Office e com.microsoft.OneDrive.
3. Exclua todas as entradas relacionadas ao OneDrive
   Clique com o botão direito em cada entrada e selecione Excluir. Confirme a exclusão. Exclua todos os itens que contenham “OneDrive” ou “Microsoft” no nome.
4. Reinicie o OneDrive
   Feche completamente o OneDrive usando o Activity Monitor. Abra o OneDrive novamente e faça login. Adicione novamente a biblioteca compartilhada.

Método 3: Conceder acesso total ao disco ao OneDrive no macOS

As configurações de privacidade do macOS podem bloquear o OneDrive de gravar na pasta de cache. Conceder Acesso Total ao Disco resolve isso.

1. Abra as Configurações do Sistema
   Clique no menu Apple > Configurações do Sistema.
2. Vá para Privacidade e Segurança
   Na barra lateral, clique em Privacidade e Segurança.
3. Selecione Acesso Total ao Disco
   Role para baixo e clique em Acesso Total ao Disco. Clique no ícone de cadeado e digite sua senha do Mac para fazer alterações.
4. Adicione o OneDrive
   Clique no botão de adição (+). Navegue até Aplicativos e selecione OneDrive.app. Clique em Abrir. Certifique-se de que a caixa de seleção ao lado do OneDrive esteja ativada.
5. Reinicie o OneDrive
   Feche e reabra o OneDrive. A biblioteca compartilhada agora deve sincronizar normalmente.

Método 4: Redefinir o cache do OneDrive via Terminal

Este método remove a pasta de cache local diretamente e é útil quando o cache está corrompido, mas a desvinculação não funcionou.

1. Feche o OneDrive
   Clique com o botão direito no ícone do OneDrive na barra de menus e selecione Sair. Confirme se solicitado.
2. Abra o Terminal
   Abra Finder > Aplicativos > Utilitários > Terminal.
3. Execute o comando de remoção de cache
   Digite o seguinte comando e pressione Enter:
   rm -rf ~/Library/CloudStorage/OneDrive-
   Isso exclui todas as pastas de cache do OneDrive para sua conta.
4. Reinicie o OneDrive
   Abra o OneDrive na pasta Aplicativos. Faça login e adicione novamente a biblioteca compartilhada. O OneDrive reconstruirá o cache do zero.

Se o OneDrive ainda mostrar Pendente após as correções principais

Biblioteca compartilhada do OneDrive mostra Pendente após atualização do macOS

As atualizações do macOS frequentemente redefinem as permissões de privacidade. Após atualizar para o macOS Sonoma ou Sequoia, o OneDrive pode perder o Acesso Total ao Disco. Reaplique o Método 3 para restaurar o acesso. Se o problema persistir, execute o comando do Terminal no Método 4 para limpar o cache e depois reaplique o Acesso Total ao Disco.

Biblioteca compartilhada do OneDrive pendente com código de erro 0x8004de40

Este erro indica um problema de conectividade de rede. Abra Configurações do Sistema > Rede e verifique sua conexão Wi-Fi ou Ethernet. Se a conexão estiver estável, o erro pode ser causado por um proxy ou VPN bloqueando o tráfego do OneDrive. Desative temporariamente qualquer VPN ou proxy e reinicie o OneDrive. Se a biblioteca sincronizar, configure a VPN para excluir onedrive.com e todos os subdomínios.

Biblioteca compartilhada do OneDrive pendente apenas para bibliotecas específicas

Se apenas uma biblioteca compartilhada mostrar pendente enquanto outras sincronizam normalmente, a biblioteca pode ter uma herança de permissão quebrada. Abra um navegador, vá para o site do SharePoint que hospeda a biblioteca e verifique as permissões da biblioteca. Certifique-se de que sua conta tenha pelo menos acesso de Leitura. Se a biblioteca estiver definida como Todos, exceto usuários externos, confirme que sua conta não é um convidado externo. Se as permissões parecerem corretas, peça ao proprietário da biblioteca para removê-lo e adicioná-lo novamente como membro.

Desvincular vs Limpar Keychain vs Acesso Total ao Disco: Principais diferenças

Item	Desvincular e vincular novamente	Limpar credenciais do Keychain	Conceder Acesso Total ao Disco
O que corrige	Cache local e metadados corrompidos	Tokens OAuth expirados ou inválidos	Bloqueios de privacidade do macOS na pasta de cache
Tempo necessário	5–10 minutos	2–3 minutos	2–3 minutos
Risco de perda de dados	Nenhum; os arquivos permanecem na nuvem do OneDrive	Nenhum; os tokens são recriados no login	Nenhum
Afeta outros aplicativos	Não	Pode afetar outros aplicativos Microsoft até que eles se reautentiquem	Não
Quando usar	Primeira tentativa para qualquer sincronização pendente	Se desvincular não funcionou ou após alteração de senha	Se pendente ocorrer após atualização do macOS

Agora você pode resolver a sincronização pendente de biblioteca compartilhada no seu Mac usando desvinculação, limpeza do Keychain ou Acesso Total ao Disco. Comece com a desvinculação, pois corrige a maioria dos problemas. Após a sincronização ser concluída, verifique se o Arquivos Sob Demanda está ativado em Preferências do OneDrive > Sincronização e backup > Configurações avançadas para economizar espaço em disco local. Se o problema retornar após uma atualização do macOS, reaplique o Acesso Total ao Disco como uma etapa preventiva.