Erro de Nome de Arquivo Muito Longo Durante a Sincronização: Causa e Solução

Ao sincronizar arquivos do SharePoint ou OneDrive com seu computador Windows, você pode ver uma mensagem de erro informando que o nome do arquivo é muito longo. Isso interrompe a sincronização desse arquivo e, às vezes, de toda a biblioteca. O erro ocorre porque o Windows tem um limite máximo de 260 caracteres no caminho, e o caminho completo, incluindo nomes de pastas, excede esse limite. Este artigo explica por que esse limite existe, como identificar os arquivos que causam o erro e as etapas para corrigir o problema renomeando arquivos ou movendo-os para caminhos mais curtos.

Por que o erro de nome de arquivo muito longo ocorre durante a sincronização

O erro é causado pela limitação MAX_PATH no sistema operacional Windows. Esse limite restringe o número total de caracteres em um caminho de arquivo a 260 caracteres. O caminho inclui a letra da unidade, dois pontos, barra invertida, todos os nomes de pastas, o nome do arquivo e a extensão do arquivo. Por exemplo, um arquivo localizado em C:\Usuários\SeuNome\OneDrive - Empresa\Projetos\2024\Q1\Marketing\Campanha\Ativos\Imagens\Final\Header\background-image-v2-final.jpg pode facilmente exceder 260 caracteres.

O aplicativo de sincronização do OneDrive respeita essa limitação do Windows. Quando tenta sincronizar um arquivo cujo caminho completo excede 260 caracteres, o Windows retorna um erro. O aplicativo de sincronização então interrompe o processamento desse arquivo e relata o erro no status da sincronização. O arquivo permanece não sincronizado e quaisquer alterações nele não serão carregadas ou baixadas até que o comprimento do caminho seja reduzido.

Esse problema é mais comum em bibliotecas de documentos do SharePoint porque os usuários geralmente criam estruturas de pastas profundamente aninhadas. Uma biblioteca com cinco ou mais níveis de subpastas combinados com nomes de arquivo longos pode facilmente atingir o limite de 260 caracteres. O erro também pode ocorrer ao sincronizar um grande número de arquivos de uma vez, pois o aplicativo de sincronização processa o caminho completo para cada arquivo.

Etapas para identificar e corrigir o erro de nome de arquivo muito longo

1. Verifique a notificação de erro de sincronização do OneDrive
   Abra o ícone do OneDrive na bandeja do sistema. Se houver um círculo vermelho com uma cruz branca, passe o mouse sobre o ícone para ver a mensagem de erro. Clique no ícone e selecione “Exibir problemas de sincronização” para ver a lista de arquivos que falharam na sincronização. A mensagem de erro dirá “O nome do arquivo é muito longo” e mostrará o caminho completo do arquivo.
2. Localize o arquivo no SharePoint ou OneDrive online
   Abra um navegador da web e vá para o site do SharePoint ou OneDrive onde o arquivo está armazenado. Navegue até o caminho da pasta mostrado na mensagem de erro. Você pode copiar o caminho da mensagem de erro e colá-lo na barra de endereços do navegador após a URL do site para ir diretamente para a pasta.
3. Renomeie o arquivo para um nome mais curto
   Selecione o arquivo e clique em “Renomear” na barra de ferramentas. Altere o nome do arquivo para uma versão mais curta. Por exemplo, altere background-image-v2-final.jpg para bg-v2.jpg. Mantenha o nome do arquivo com menos de 30 caracteres, se possível. Isso reduz o comprimento total do caminho.
4. Mova o arquivo para uma pasta mais superficial
   Se renomear não for suficiente, mova o arquivo para uma pasta mais próxima da raiz da biblioteca. Recorte o arquivo e cole-o em uma pasta de nível superior. Você também pode criar uma nova pasta com um nome curto no nível raiz e mover o arquivo para lá.
5. Reestruture a hierarquia de pastas
   Para problemas recorrentes, considere achatar a estrutura de pastas. Limite o aninhamento a três níveis de profundidade. Use colunas de metadados e exibições no SharePoint para organizar arquivos em vez de criar subpastas profundas. Por exemplo, use uma coluna “Ano” e uma coluna “Projeto” em vez de pastas como \2024\Q1\Marketing\Campanha\.
6. Ative o suporte a caminhos longos no Windows
   No Windows 10 versão 1607 e posteriores, e no Windows 11, você pode ativar o suporte para caminhos com mais de 260 caracteres. Isso remove a limitação para aplicativos que reconhecem a configuração, incluindo o aplicativo de sincronização do OneDrive. Para ativar, abra o Editor de Política de Grupo digitando gpedit.msc na caixa de diálogo Executar. Navegue até Configuração do Computador > Modelos Administrativos > Sistema > Sistema de Arquivos. Clique duas vezes em “Habilitar caminhos longos do Win32” e defina como Habilitado. Reinicie o computador. Se o Editor de Política de Grupo não estiver disponível, use o registro: abra o Editor de Registro e vá para HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem. Defina LongPathsEnabled como 1. Reinicie o computador.
7. Retome a sincronização após a correção
   Após renomear ou mover o arquivo, o aplicativo de sincronização do OneDrive deve tentar sincronizar novamente automaticamente. Se não o fizer, clique com o botão direito no ícone do OneDrive na bandeja do sistema e selecione “Retomar sincronização”. Você também pode pausar e retomar a sincronização no mesmo menu.

Se o erro de sincronização persistir após corrigir os nomes dos arquivos

Arquivos ainda mostram o erro após renomear

Se o erro continuar, verifique se outro arquivo na mesma pasta também tem um caminho longo. O aplicativo de sincronização relata um arquivo por vez, mas vários arquivos podem ser afetados. Revise toda a lista de problemas de sincronização clicando em “Exibir problemas de sincronização” nas configurações do OneDrive. Renomeie ou mova cada arquivo listado.

O erro aparece para arquivos na raiz da biblioteca

Se um arquivo na pasta raiz mostrar o erro, o nome do arquivo em si é muito longo. Os nomes dos arquivos devem ser mantidos com menos de 100 caracteres. Renomeie o arquivo para um nome mais curto. Verifique também se o caminho da pasta local no seu computador é longo. O caminho completo inclui o local da pasta do OneDrive, que pode adicionar caracteres. Por exemplo, C:\Usuários\SeuNome\OneDrive - Empresa\ pode ter 40 caracteres ou mais. Mova a pasta do OneDrive para um caminho mais curto como C:\OneDrive\ alterando as configurações do OneDrive.

O erro ocorre apenas em um computador específico

Se o mesmo arquivo sincronizar corretamente em outro computador, mas falhar neste, o comprimento do caminho local é diferente. Verifique se o computador tem um nome de usuário longo ou uma estrutura de pastas profunda no local de sincronização do OneDrive. Encurte o nome da pasta do usuário criando uma nova conta de usuário do Windows com um nome curto e reconfigurando o OneDrive nessa conta.

Método	Eficácia	Quando usar
Renomear o arquivo	Correção rápida para arquivos individuais	Quando apenas alguns arquivos têm nomes longos
Mover arquivo para pasta mais superficial	Reduz o comprimento do caminho sem renomear	Quando os nomes das pastas são longos, mas o nome do arquivo é curto
Reestruturar hierarquia de pastas	Previne erros futuros	Quando a biblioteca tem aninhamento profundo
Ativar suporte a caminhos longos	Correção permanente em todo o sistema	Quando os usuários precisam de estruturas de pastas profundas

Após aplicar qualquer um desses métodos, você pode retomar a sincronização dos arquivos que estavam bloqueados. O aplicativo de sincronização do OneDrive processará os caminhos corrigidos e carregará ou baixará os arquivos com sucesso.