Sincronização do SharePoint/OneDrive travada em “Processando alterações”: o que os proprietários do site devem verificar

Quando o cliente de sincronização do OneDrive exibe “Processando alterações” para uma biblioteca de documentos do SharePoint e nunca termina, os proprietários do site enfrentam fluxos de trabalho parados e usuários frustrados. Esse estado travado geralmente ocorre porque o cliente de sincronização está sobrecarregado por um grande número de alterações de arquivos, atualizações conflitantes de metadados ou um cache de sincronização local corrompido. Neste artigo, você aprenderá as causas específicas por trás desse sintoma e as etapas exatas que os proprietários do site podem seguir para resolvê-lo sem esperar pelo suporte da Microsoft.

Por que o cliente de sincronização trava em “Processando alterações”

O cliente de sincronização do OneDrive se comunica com o SharePoint comparando metadados de arquivos entre o cache local e o servidor. Quando essa comparação de metadados não pode ser concluída, o cliente exibe “Processando alterações” indefinidamente. A causa raiz é quase sempre um destes três cenários:

Muitas alterações de arquivos de uma vez

Se um proprietário do site ou processo automatizado move, renomeia ou edita centenas de arquivos em um curto período, o cliente de sincronização precisa processar cada alteração individualmente. O cliente enfileira essas alterações, mas pode travar se a fila ultrapassar 10.000 itens. Isso é comum após migrar arquivos, reestruturar pastas ou executar uma atualização em massa de metadados.

Cache de sincronização local corrompido

O cliente de sincronização armazena um banco de dados local de metadados de arquivos. Se esse banco de dados for corrompido devido a uma falha do sistema, erro de disco ou desligamento abrupto, o cliente não consegue reconciliar seu estado local com o SharePoint. O resultado é um estado permanente de “Processando alterações” que persiste mesmo após reiniciar o cliente ou o computador.

Limites de armazenamento ou limitação do site do SharePoint

O SharePoint Online aplica limitação quando um site excede sua cota de armazenamento ou quando um usuário faz mais de 5.000 alterações de arquivos por hora. O cliente de sincronização recebe um sinal de atraso do servidor e entra em um loop de espera. Os proprietários do site devem verificar as métricas de armazenamento do site na central de administração do SharePoint para confirmar que esse não é o problema.

Etapas para resolver a sincronização travada para proprietários do site

Os proprietários do site devem seguir estas etapas em ordem. Cada etapa aborda uma causa possível diferente. Não pule nenhuma etapa.

1. Pausar e retomar a sincronização
   Abra o cliente de sincronização do OneDrive clicando no ícone de nuvem do OneDrive na bandeja do sistema. Selecione Ajuda e Configurações > Pausar sincronização e escolha 2 horas. Após o período de pausa terminar, o cliente retomará. Isso força o cliente a reavaliar a fila de alterações e geralmente limpa um backlog temporário. Se o estado travado retornar, vá para a etapa 2.
2. Parar a sincronização da biblioteca afetada
   No cliente de sincronização do OneDrive, clique em Ajuda e Configurações > Configurações. Vá para a guia Conta. Na biblioteca do SharePoint que está travada, clique em Parar sincronização. Isso remove a pasta local, mas não exclui seus arquivos do SharePoint. Após parar a sincronização, reinicie o cliente do OneDrive e adicione novamente a biblioteca acessando o site do SharePoint e clicando em Sincronizar novamente. Isso cria um cache local novo.
3. Limpar o cache de sincronização do OneDrive
   Se parar a sincronização não ajudar, limpe todo o cache de sincronização. Feche o OneDrive completamente clicando com o botão direito no ícone de nuvem e selecionando Sair. Pressione Tecla Windows + R, digite %localappdata%\Microsoft\OneDrive\settings\Business1 e pressione Enter. Exclua todos os arquivos nesta pasta. Em seguida, reinicie o OneDrive. Isso força o cliente a reconstruir seu banco de dados do zero. Nota: esta etapa exige que o usuário ressincronize todas as bibliotecas.
4. Verificar o armazenamento do site do SharePoint
   Vá para a Central de administração do SharePoint > Sites ativos. Selecione o site onde a biblioteca está localizada. Clique em Configurações e veja o Limite de armazenamento. Se o site estiver perto ou acima do limite, aumente a cota de armazenamento ou remova arquivos não utilizados. Após ajustar, aguarde 30 minutos para a alteração se propagar antes de tentar sincronizar novamente.
5. Revisar o status de limitação
   Na central de administração do SharePoint, vá para Relatórios > Análise de uso. Procure o site em questão e verifique a métrica Chamadas de API. Se o site mostrar mais de 5.000 chamadas de API por hora, a limitação está ativa. Reduza o número de operações automatizadas no site. Os culpados comuns são fluxos do Power Automate, scripts personalizados ou uploads em massa de arquivos. Após reduzir a atividade, a limitação é suspensa automaticamente dentro de 24 horas.

Se o SharePoint ainda tiver problemas após a correção principal

Sincronização travada em um único arquivo grande

Um único arquivo maior que 250 GB não pode ser sincronizado. O cliente exibe “Processando alterações” enquanto falha repetidamente ao fazer upload ou download do arquivo. Verifique a biblioteca em busca de arquivos que excedam o limite. Use a coluna de tamanho de arquivo do SharePoint para classificar por tamanho. Remova ou comprima o arquivo muito grande. Após a remoção, reinicie o OneDrive e retome a sincronização.

Sincronização travada após renomear uma pasta

Renomear uma pasta que contém milhares de arquivos força o cliente de sincronização a reprocessar cada caminho de arquivo. Isso pode causar um estado travado de várias horas. Para evitar isso no futuro, renomeie pastas apenas quando elas contiverem menos de 100 arquivos. Se já estiver travado, pare a sincronização da biblioteca e adicione-a novamente (etapa 2 acima).

Sincronização travada devido ao nome do arquivo ou comprimento do caminho

O SharePoint e o OneDrive suportam caminhos de arquivo de até 400 caracteres. Arquivos com caminhos mais longos ou nomes que incluem caracteres inválidos como # % & { } \ fazem o cliente de sincronização travar. Use o recurso Fazer check-out do SharePoint para identificar arquivos com nomes inválidos. Renomeie ou mova esses arquivos para um caminho mais curto. Em seguida, reinicie o cliente de sincronização.

Controles de sincronização do proprietário do site vs controles de sincronização do usuário final

Item	Controles do proprietário do site	Controles do usuário final
Local de acesso	Central de administração do SharePoint > Sites ativos > Configurações do site	Cliente de sincronização do OneDrive > Configurações > guia Conta
Limite de armazenamento	Pode aumentar ou reduzir a cota de armazenamento do site	Não pode alterar o armazenamento; só pode ver o espaço usado
Bloqueio de sincronização	Pode bloquear a sincronização de todo o site por meio de política de locatário	Pode parar a sincronização apenas para bibliotecas individuais
Limites de tamanho de arquivo	Não pode alterar o limite de 250 GB; deve informar os usuários	Não pode alterar o limite; deve evitar arquivos grandes
Visibilidade de limitação	Pode ver o uso da API na análise de uso	Não pode ver dados de limitação

Os proprietários do site têm acesso a controles de armazenamento e limitação que os usuários finais não têm. Quando a sincronização estiver travada, comece com as verificações no nível do site antes de pedir aos usuários que limpem o cache.

Agora você conhece as três principais causas do estado travado de “Processando alterações” e as cinco etapas para resolvê-lo. Comece pausando a sincronização e, em seguida, pare a sincronização da biblioteca afetada. Se o problema persistir, verifique a cota de armazenamento do site na central de administração do SharePoint. Para problemas recorrentes, reduza o número de operações automatizadas de arquivos no site para permanecer dentro do limite de 5.000 alterações por hora.