Checklist do Administrador do OneDrive: loops de sincronização de bibliotecas compartilhadas após reinicialização no Mac

Usuários de Mac na sua organização podem ver o OneDrive entrar em um loop de sincronização após reiniciar o computador. O ícone do OneDrive mostra sincronizando, para e recomeça sem concluir. Esse problema geralmente acontece com bibliotecas compartilhadas que têm estruturas de pastas profundas ou um grande número de arquivos. Este artigo explica por que bibliotecas compartilhadas disparam loops de sincronização no Mac, fornece um checklist passo a passo para administradores interromperem o loop e lista padrões de falha relacionados que você deve verificar antes de entrar em contato com o suporte.

Por que as bibliotecas compartilhadas do OneDrive entram em loops de sincronização após reinicialização no Mac

Quando um Mac reinicia, o OneDrive reavalia todas as bibliotecas sincronizadas. Para bibliotecas compartilhadas, o banco de dados de sincronização local pode ficar desatualizado se a biblioteca foi modificada enquanto o usuário estava offline ou se uma sincronização anterior foi interrompida. O OneDrive tenta reconciliar o estado local com o estado do servidor, mas o banco de dados não tem um token delta válido. Isso força uma varredura completa da biblioteca. Em bibliotecas com mais de 10.000 itens ou pastas aninhadas, a varredura pode expirar, fazendo com que o OneDrive reinicie o ciclo de sincronização do início. O resultado é um loop infinito: varredura, tempo limite, reinício, varredura novamente.

Dois comportamentos específicos no macOS 14 Sonoma e posteriores pioram isso. Primeiro, o macOS suspende agressivamente processos em segundo plano após uma reinicialização para economizar bateria. O OneDrive pode ser suspenso no meio da sincronização, corrompendo o cache local. Segundo, o sistema de arquivos APFS faz backups baseados em snapshots que podem bloquear arquivos que o OneDrive está tentando gravar, fazendo com que o mecanismo de sincronização falhe e tente novamente. Esses fatores se combinam para criar um loop persistente que só é interrompido quando o cache local é limpo ou a biblioteca é readicionada.

Checklist do administrador: 5 etapas para interromper um loop de sincronização de biblioteca compartilhada

Siga este checklist em ordem. Cada etapa foi projetada para isolar o problema sem forçar o usuário a baixar novamente a biblioteca inteira.

1. Verifique o status de sincronização do OneDrive
   Abra o OneDrive pela barra de menus. Clique no ícone do OneDrive e selecione Ajuda e Configurações > Preferências > Conta. Em Bibliotecas compartilhadas, procure a biblioteca que mostra um ícone girando ou um status que muda a cada poucos segundos. Anote o nome da biblioteca e o número de itens exibidos. Se o número oscilar para cima e para baixo, o loop está ativo.
2. Pause e retome a sincronização do OneDrive
   Na mesma janela de Preferências, clique na guia Rede. Defina Limite de taxa de download para 1 Mbps temporariamente. Clique em Pausar sincronização por 2 horas, aguarde 30 segundos e clique em Retomar sincronização. Isso força o OneDrive a solicitar um novo token delta do servidor em vez de continuar a varredura local corrompida. Se o loop parar, o problema era um token local desatualizado. Reverta o limite de taxa para o valor original.
3. Desmarque e remarque a biblioteca compartilhada
   Vá para Preferências > Conta > Bibliotecas compartilhadas. Desmarque a caixa ao lado da biblioteca com loop. Aguarde 10 segundos. Marque a caixa novamente. O OneDrive reautenticará a biblioteca e baixará um novo token de sincronização. Esta é a correção mais eficaz e resolve cerca de 80% dos loops de sincronização. Se o loop retornar após a próxima reinicialização, prossiga para a etapa 4.
4. Exclua o cache local da biblioteca compartilhada
   Saia completamente do OneDrive. Abra o Finder e pressione Shift+Command+G. Digite ~/Library/Application Support/OneDrive/settings/Business1/SharedWithMe. Localize a pasta com o mesmo nome da biblioteca com loop. Dentro dela, exclua os arquivos que terminam em .db e .db-wal. Não exclua a pasta em si. Reinicie o OneDrive. A biblioteca será sincronizada do zero, mas apenas o cache de metadados é reconstruído, não o conteúdo dos arquivos. Isso geralmente leva de 5 a 10 minutos para uma biblioteca com 50.000 itens.
5. Remova e readicione a biblioteca compartilhada
   Se o loop persistir, remova a biblioteca completamente. Em Preferências > Conta > Bibliotecas compartilhadas, clique nos três pontos ao lado da biblioteca e escolha Remover do OneDrive. Confirme a remoção. Reinicie o OneDrive. Readicione a biblioteca clicando em Adicionar uma biblioteca compartilhada e selecionando-a na lista. Esta é a opção nuclear e força uma sincronização completa de todos os arquivos. Avise o usuário que ressincronizar uma biblioteca grande pode levar várias horas.

Se o OneDrive ainda estiver em loop após a correção principal

Se o checklist acima não interromper o loop, verifique estes três padrões de falha relacionados.

OneDrive sincroniza para sempre após atualização do macOS

Uma atualização do macOS pode alterar a forma como o OneDrive interage com snapshots do APFS. Após uma atualização importante como 14.1 para 14.2, o OneDrive pode falhar ao gravar seu arquivo de token delta. A correção é executar OneDrive > Ajuda e Configurações > Preferências > Avançado > Redefinir OneDrive. Isso limpa todo o cache local e força um download novo de todas as bibliotecas. Leva mais tempo, mas garante um estado limpo.

OneDrive mostra um X vermelho em arquivos do Office compartilhados

Um loop de sincronização pode deixar alguns arquivos com um ícone de X vermelho mesmo após o loop parar. Isso acontece porque o cache de status do arquivo está corrompido. Abra o arquivo pelo navegador, faça uma pequena edição, salve e abra-o novamente pela pasta local. O OneDrive ressincronizará o arquivo e limpará o X vermelho. Para vários arquivos, use o truque de OneDrive > Ajuda e Configurações > Pausar sincronização > Retomar sincronização para acionar uma atualização em massa do status.

OneDrive não encontra a biblioteca compartilhada após reinicialização

Se a biblioteca compartilhada desaparecer da barra lateral do Finder após uma reinicialização, a biblioteca pode ter sido removida da conta do OneDrive do usuário por um administrador. Verifique o centro de administração do Microsoft 365 em Centros de administração > SharePoint > Sites ativos. Confirme se o conjunto de sites da biblioteca compartilhada não foi excluído ou está em modo somente leitura. Se o site estiver ativo, peça ao usuário para ir em Preferências > Conta > Bibliotecas compartilhadas e clicar em Adicionar uma biblioteca compartilhada para redescobri-la.

Comportamento de sincronização de bibliotecas compartilhadas: Mac vs Windows

Item	OneDrive no macOS	OneDrive no Windows
Armazenamento do token delta	~/Library/Application Support/OneDrive/settings/Business1/SharedWithMe	%LocalAppData%\Microsoft\OneDrive\settings\Business1\SharedWithMe
Prioridade do processo em segundo plano	Baixa – macOS suspende após reinicialização	Normal – Windows mantém sincronização ativa
Causa típica do loop de sincronização	Token delta desatualizado + bloqueio do APFS	Arquivo de banco de dados local corrompido
Correção sem novo download	Desmarcar/remarcar biblioteca	Redefinir OneDrive pelas Configurações

A tabela mostra que usuários de Mac têm mais probabilidade de encontrar loops de sincronização devido à suspensão em nível de sistema operacional e ao bloqueio do sistema de arquivos. O método de desmarcar/remarcar funciona em ambas as plataformas, mas é mais confiável no Mac porque força um novo token delta sem tocar no cache de arquivos local.

Após aplicar o checklist, o usuário deve ver uma barra de progresso de sincronização constante que é concluída em até 30 minutos para a maioria das bibliotecas compartilhadas. Para evitar recorrências, instrua os usuários a manter o OneDrive em execução no login marcando Preferências > Geral > Iniciar o OneDrive automaticamente quando eu fizer login no Windows – no Mac, essa configuração é chamada Abrir o OneDrive automaticamente quando eu fizer login no meu Mac. Defina também Preferências > Rede > Limite de taxa de download para pelo menos 10 Mbps para evitar tempos limite durante a sincronização inicial após a reinicialização.