Como Evitar o Erro de Nome de Arquivo Muito Longo Durante a Sincronização
🔍 WiseChecker

Como Evitar o Erro de Nome de Arquivo Muito Longo Durante a Sincronização

Ao sincronizar arquivos do SharePoint ou OneDrive com seu computador, o processo pode parar com um erro de nome de arquivo muito longo. Esse erro ocorre porque o Windows e o OneDrive têm um limite combinado de 400 caracteres no caminho. O erro impede que a pasta ou arquivo seja sincronizado e pode bloquear toda a fila de sincronização.

A causa raiz é que o SharePoint permite caminhos de até 400 caracteres, mas ao sincronizar, o caminho local completo (incluindo a estrutura de pastas do seu computador) excede esse limite. Este artigo explica como identificar e corrigir caminhos de arquivo longos antes que causem falhas de sincronização. Você aprenderá etapas específicas para encurtar nomes de pastas, reestruturar bibliotecas e usar configurações do OneDrive para evitar o erro.

Principais Conclusões: Evitar o Erro de Nome de Arquivo Muito Longo Durante a Sincronização

  • Aplicativo de sincronização do OneDrive > Configurações > Rede: Ative a imposição do limite de comprimento do caminho do arquivo para bloquear caminhos excessivamente longos antes do início da sincronização.
  • Explorador de Arquivos > Renomear: Encurte nomes de pastas e arquivos para 50 caracteres ou menos para manter o caminho total abaixo de 400 caracteres.
  • Biblioteca de documentos do SharePoint > Classificação de colunas: Classifique pela coluna Comprimento do Caminho para identificar rapidamente arquivos que excedem o limite.

ADVERTISEMENT

Por que o Erro de Nome de Arquivo Muito Longo Ocorre Durante a Sincronização

O erro de nome de arquivo muito longo acontece devido ao limite de 400 caracteres no caminho imposto pelo aplicativo de sincronização do OneDrive. Ao sincronizar uma biblioteca do SharePoint com seu computador, o aplicativo de sincronização cria uma cópia local da estrutura de pastas. O caminho completo para um arquivo inclui sua pasta de usuário do Windows, a pasta raiz do OneDrive, o nome do site do SharePoint e todas as pastas aninhadas.

O SharePoint em si suporta caminhos de até 400 caracteres. No entanto, o caminho local adiciona caracteres da letra da unidade do computador, nome de usuário e nome da pasta do OneDrive. Por exemplo, um arquivo em C:\Usuários\João\OneDrive - Contoso\Documentos Compartilhados\Projeto Alfa\Relatórios\Q4\Final\rascunho-v3.docx contém 97 caracteres apenas do prefixo local. Se o caminho do lado do SharePoint for 310 caracteres, o total excede 400 e a sincronização falha.

O erro aparece como um círculo vermelho com uma cruz branca no ícone da bandeja do sistema do OneDrive. O aplicativo de sincronização mostra uma notificação informando “Nome de arquivo muito longo” e lista o arquivo afetado. A fila de sincronização para de processar todos os arquivos até que você corrija o problema de caminho.

Limites de Caracteres para Diferentes Cenários de Sincronização

O limite de 400 caracteres se aplica ao caminho local completo. Se você sincronizar com uma unidade externa ou local de rede, o comprimento do caminho pode ser menor devido à profundidade adicional de pastas. O aplicativo de sincronização do OneDrive também limita nomes de arquivo individuais a 255 caracteres. Nomes de pasta podem ter até 250 caracteres, mas combinar muitas pastas profundas consome rapidamente o orçamento do caminho.

Etapas para Identificar e Corrigir Caminhos de Arquivo Longos

Use estas etapas para encontrar arquivos com caminhos longos e encurtá-los antes que a sincronização falhe.

  1. Abra as configurações do aplicativo de sincronização do OneDrive
    Clique com o botão direito no ícone de nuvem do OneDrive na bandeja do sistema. Selecione Configurações. Vá para a guia Rede. Em Limite de comprimento do caminho do arquivo, marque a caixa que diz “Impor o limite de 400 caracteres no comprimento do caminho”. Clique em OK. Essa configuração impede que arquivos com caminhos acima de 400 caracteres sejam sincronizados e mostra um aviso em vez de uma falha silenciosa.
  2. Verifique o status de sincronização para avisos de caminho longo
    No ícone da bandeja do sistema do OneDrive, clique no ícone de nuvem e selecione Exibir problemas de sincronização. A lista mostra arquivos com erros de comprimento de caminho. Anote o caminho completo de cada arquivo bloqueado.
  3. Abra a biblioteca de documentos do SharePoint em um navegador
    Vá para o site do SharePoint que contém a biblioteca sincronizada. Navegue até a biblioteca de documentos onde os arquivos de caminho longo residem. Clique no nome da biblioteca no cabeçalho e selecione Configurações da biblioteca.
  4. Adicione a coluna Comprimento do Caminho à exibição da biblioteca
    Em Configurações da biblioteca, clique em Criar coluna. Nomeie a coluna como “Comprimento do Caminho”. Escolha Calculado como o tipo de coluna. Na caixa de fórmula, insira =LEN([Caminho Completo]). Clique em OK. Volte para a biblioteca e adicione esta coluna à sua exibição atual. A coluna exibe a contagem de caracteres do caminho do SharePoint de cada arquivo.
  5. Classifique os arquivos por Comprimento do Caminho em ordem decrescente
    Clique no cabeçalho da coluna Comprimento do Caminho para classificar do maior para o menor. Identifique arquivos com comprimento de caminho acima de 350 caracteres. Esses arquivos estão em risco de exceder o limite de 400 caracteres quando combinados com o prefixo do caminho local.
  6. Encurte nomes de pastas e nomes de arquivos
    Para cada arquivo em risco, renomeie pastas ou o próprio arquivo para reduzir o comprimento total do caminho. Use abreviações para nomes de pastas. Por exemplo, altere “Relatórios Financeiros Trimestrais” para “RelFinTrim”. Mantenha nomes de arquivo abaixo de 50 caracteres. Após renomear, a coluna Comprimento do Caminho é atualizada automaticamente.
  7. Mova arquivos para um nível de pasta mais raso
    Se renomear não for suficiente, mova os arquivos um ou dois níveis de pasta acima. Crie uma nova pasta na raiz da biblioteca com um nome curto. Mova os arquivos profundos para essa pasta. Atualize quaisquer links ou referências para o novo local.
  8. Reinicie a sincronização do OneDrive
    Após fazer as alterações, clique com o botão direito no ícone do OneDrive e selecione Pausar sincronização por 2 horas. Aguarde 30 segundos e clique em Retomar sincronização. O aplicativo de sincronização reavalia todos os arquivos e deve processar os caminhos encurtados sem erro.

ADVERTISEMENT

Se o SharePoint Ainda Tiver Problemas Após Encurtar os Caminhos

A sincronização ainda falha mesmo após renomear arquivos

Se o erro persistir, o prefixo do caminho local pode ser maior do que o esperado. Verifique o local da pasta local do OneDrive. Vá para Configurações do OneDrive > guia Conta > Escolher pastas. Observe o caminho raiz mostrado em Sua pasta do OneDrive. Se seu nome de usuário do Windows for longo ou a letra da unidade for profunda, considere mover a pasta do OneDrive para um caminho mais curto. Em Configurações do OneDrive > Backup > Gerenciar backup, clique em Alterar local e selecione uma pasta raiz como C:\OneDrive em vez de C:\Usuários\NomeLongo\OneDrive.

Nomes de pastas no SharePoint são muito longos para editar

Se uma pasta tiver um nome com mais de 100 caracteres, o SharePoint pode se recusar a renomeá-la. Nesse caso, crie uma nova pasta com um nome curto no mesmo nível. Selecione todos os arquivos da pasta de nome longo, clique em Mover para e escolha a nova pasta. Exclua a pasta original vazia após confirmar que todos os arquivos foram movidos.

A sincronização do OneDrive mostra “Caminho muito longo” para um único arquivo

Um único arquivo com um nome muito longo pode bloquear toda a fila de sincronização. Abra o SharePoint em um navegador. Navegue até o arquivo. Clique no nome do arquivo e selecione Renomear. Encurte o nome para 50 caracteres ou menos. A fila de sincronização retoma o processamento de outros arquivos em alguns minutos.

Item Limite de Caminho no SharePoint Limite de Caminho na Sincronização Local
Caminho total máximo 400 caracteres 400 caracteres (prefixo local incluído)
Nome de arquivo individual 255 caracteres 255 caracteres
Nome de pasta individual 250 caracteres 250 caracteres
Exemplo de prefixo local padrão N/A C:\Usuários\Nome\OneDrive - Empresa\ (aprox. 40-60 caracteres)
Caminho máximo recomendado no SharePoint 350 caracteres 350 caracteres para deixar espaço para o prefixo local

Após aplicar as etapas deste artigo, você pode evitar o erro de nome de arquivo muito longo durante a sincronização. Comece ativando a imposição do limite de comprimento do caminho nas configurações do OneDrive. Em seguida, use a coluna Comprimento do Caminho no SharePoint para monitorar e encurtar caminhos profundos. Para gerenciamento contínuo, estabeleça uma convenção de nomenclatura que mantenha nomes de pastas e arquivos abaixo de 50 caracteres cada. Essa prática reduz a chance de atingir o limite de 400 caracteres mesmo à medida que sua biblioteca cresce.

ADVERTISEMENT