Separar Erros de Permissão de Erros de Sincronização: Configuração Passo a Passo

Ao trabalhar com bibliotecas de documentos do SharePoint, você pode ver erros que interrompem a sincronização de arquivos. Alguns erros vêm das configurações de permissão, enquanto outros vêm do mecanismo de sincronização. Esses dois tipos de erros parecem semelhantes, mas exigem correções diferentes. Este artigo mostra como diferenciá-los e configurar seu sistema para evitar confusão.

Por Que Erros de Permissão e Erros de Sincronização Parecem Iguais

O SharePoint e o OneDrive usam o mesmo aplicativo cliente de sincronização. Quando um arquivo falha ao sincronizar, o cliente mostra uma mensagem de erro genérica. A mensagem geralmente diz “Você não tem permissão para sincronizar esta pasta” ou “Algo deu errado.” Essas mensagens não informam a causa raiz.

Erros de permissão ocorrem quando o usuário não tem acesso de leitura ou gravação a um site, biblioteca ou pasta do SharePoint. Erros de sincronização ocorrem quando o mecanismo de sincronização do OneDrive não consegue baixar ou enviar um arquivo devido a um conflito, arquivo bloqueado ou cache corrompido. O cliente de sincronização trata ambos como falha e mostra o mesmo ícone de status.

Para corrigir o problema certo, você deve separar os dois. O cliente de sincronização pode relatar um erro de permissão mesmo quando o usuário tem acesso total. Esse relatório incorreto ocorre quando o mecanismo de sincronização perde seu token de autenticação ou quando um arquivo está com check-out por outro usuário. Da mesma forma, um erro de permissão real pode aparecer como um erro de sincronização se o cliente de sincronização não conseguir ler as permissões do site corretamente.

Passos para Configurar a Separação de Erros

Siga estes passos para configurar seu ambiente SharePoint e OneDrive para que erros de permissão e erros de sincronização apareçam em lugares diferentes. Esta configuração usa o centro de administração do SharePoint, as configurações de sincronização do OneDrive e o Visualizador de Eventos do Windows.

Passo 1: Habilitar Log Detalhado de Sincronização

1. Abra as Configurações do OneDrive
   Clique com o botão direito no ícone do OneDrive na bandeja do sistema e selecione Configurações. Vá para a guia Sincronização e backup.
2. Ative o log detalhado
   Na seção Avançado, marque a caixa “Coletar logs automaticamente.” Essa configuração faz o cliente de sincronização escrever códigos de erro detalhados no arquivo de log em vez de mensagens genéricas.
3. Reinicie o OneDrive
   Clique em OK, depois clique com o botão direito no ícone do OneDrive e selecione Fechar OneDrive. Abra o OneDrive novamente pelo menu Iniciar. O novo nível de log entra em vigor imediatamente.

Passo 2: Configurar Alertas de Permissão do SharePoint

1. Abra o centro de administração do SharePoint
   Vá para https://admin.microsoft.com/Sharepoint. Faça login como administrador do SharePoint.
2. Vá para Políticas > Compartilhamento
   Na navegação à esquerda, selecione Políticas e depois Compartilhamento. Em Compartilhamento externo, defina o nível de permissão para cada site. Este passo não corrige erros, mas garante que as alterações de permissão sejam registradas no log de auditoria.
3. Habilite o log de auditoria para alterações de permissão
   No centro de administração do SharePoint, vá para Relatórios > Log de auditoria. Ative o log de auditoria se estiver desativado. As alterações de permissão agora aparecem no log de auditoria com um ID de evento separado.

Passo 3: Usar o Visualizador de Eventos do Windows para Filtrar Erros

1. Abra o Visualizador de Eventos
   Pressione a tecla Windows + R, digite eventvwr.msc e pressione Enter.
2. Navegue até os logs do OneDrive
   Expanda Logs de Aplicativos e Serviços > Microsoft > Windows > OneDrive Sync. Selecione Operacional.
3. Filtre por códigos de erro
   No painel direito, clique em Filtrar Log Atual. No campo ID do Evento, digite 1001 para erros de permissão e 1003 para erros de sincronização. Clique em OK. O log agora mostra apenas o tipo de erro que você deseja ver.

Passo 4: Configurar Canais de Notificação Separados

1. Crie um alerta do SharePoint para alterações de permissão
   Em um site do SharePoint, vá para a biblioteca, clique nos três pontos (reticências) e selecione Alertar-me. Configure o alerta para notificá-lo quando alguém alterar permissões. Esse alerta vai para seu e-mail, separado das notificações de erro de sincronização.
2. Desative as notificações do OneDrive para erros de sincronização
   Em Configurações do OneDrive > Sincronização e backup > Avançado, desmarque “Mostrar notificações de sincronização.” Os erros de sincronização ainda aparecerão no log, mas não gerarão mensagens pop-up que parecem erros de permissão.

Se Erros de Permissão Ainda Aparecerem como Erros de Sincronização Após a Configuração

OneDrive Relata “Acesso Negado” mas o Usuário Tem Permissões Completas

Essa situação ocorre quando o token de autenticação do usuário expirou. O cliente de sincronização tenta acessar o site do SharePoint, mas o token é inválido. O cliente exibe “Acesso Negado” mesmo que o usuário ainda tenha permissões. Para corrigir, saia do OneDrive e entre novamente. Clique com o botão direito no ícone do OneDrive, selecione Configurações > Conta > Desvincular este PC. Em seguida, faça login novamente com a mesma conta corporativa ou de estudante.

Erro de Sincronização Diz “Arquivo em Uso” mas Ninguém Tem o Arquivo Aberto

Esse erro pode ocorrer quando uma sincronização anterior deixou um bloqueio no arquivo. O bloqueio persiste mesmo após o usuário fechar o arquivo. O cliente de sincronização relata um erro de sincronização, mas o problema real é um bloqueio obsoleto. Para resolver, use o centro de administração do SharePoint para forçar um check-in. Vá para a biblioteca de documentos, selecione o arquivo e escolha Fazer Check-in no menu. Se nenhuma opção de check-in aparecer, o arquivo não está com check-out. Nesse caso, limpe o cache de sincronização parando a sincronização e removendo a pasta local.

Erro de Permissão Aparece Após uma Migração de Site

Quando um site do SharePoint é movido para uma região diferente ou renomeado, o cliente de sincronização pode continuar usando a URL antiga. A URL antiga não tem mais as permissões do usuário, então o cliente mostra um erro de permissão. Para corrigir, remova o site da sincronização do OneDrive e adicione-o novamente usando a nova URL. Vá para Configurações do OneDrive > Conta > Escolher pastas. Clique em Cancelar sincronização para a biblioteca afetada, depois clique em Sincronizar arquivos e selecione a mesma biblioteca do novo site.

Erro de Permissão vs Erro de Sincronização: Principais Diferenças

Item	Erro de Permissão	Erro de Sincronização
Mensagem de erro típica	“Você não tem acesso a esta pasta”	“Algo deu errado durante a sincronização”
ID do Visualizador de Eventos	1001	1003
Causa raiz	Usuário não tem permissão de leitura ou gravação no site ou biblioteca do SharePoint	Conflito de arquivo, bloqueio de arquivo, cache corrompido ou problema de rede temporário
Correção típica	Adicionar o usuário às permissões do site ou biblioteca do SharePoint	Limpar o cache de sincronização ou fazer check-in do arquivo
Canal de notificação	Alerta do SharePoint (e-mail) ou centro de administração	Ícone de status de sincronização do OneDrive ou arquivo de log

Conclusão

Agora você pode identificar erros de permissão e erros de sincronização observando o filtro do Visualizador de Eventos e o arquivo de log do OneDrive. Os passos de configuração neste artigo permitem que você veja cada tipo de erro em uma visualização separada. Comece habilitando o log detalhado no OneDrive e criando um alerta do SharePoint para alterações de permissão. Use o Visualizador de Eventos com os IDs de evento 1001 e 1003 para isolar a causa raiz. Se ainda vir erros mistos, verifique o token de autenticação saindo e entrando novamente no OneDrive.