O OneDrive for Business para de sincronizar um arquivo e exibe o erro “Este arquivo não pode ser sincronizado porque o caminho é muito longo.” Isso acontece porque o Windows e o OneDrive têm um limite combinado de caracteres para o caminho completo do arquivo, incluindo a estrutura de pastas e o nome do arquivo. Quando o caminho excede 400 caracteres, o OneDrive bloqueia a sincronização para evitar erros no sistema de arquivos. Este artigo explica por que o limite existe, como identificar quais arquivos são afetados e as etapas exatas para renomear ou mover arquivos para que sincronizem novamente.
Principais conclusões: corrigindo o erro de caminho muito longo no OneDrive
- Ícone de status de sincronização do OneDrive no File Explorer: Passe o mouse sobre o ícone vermelho ou amarelo para ver o caminho exato do arquivo que excede o limite.
- Barra de pesquisa do File Explorer > length:>400: Use este filtro de pesquisa para encontrar arquivos com caminhos com mais de 400 caracteres na sua pasta do OneDrive.
- PowerShell Get-ChildItem com a propriedade Length: Execute um script para listar todos os arquivos com caminhos completos que excedem 400 caracteres e exportá-los para um CSV para edição em lote.
Por que o OneDrive bloqueia arquivos com caminhos longos
O OneDrive for Business impõe um limite de 400 caracteres para o caminho completo do arquivo, que inclui a letra da unidade, nomes de pastas, subpastas e o nome do arquivo com extensão. Esse limite vem da API do Windows que o OneDrive usa para ler e gravar arquivos. Quando um caminho de arquivo excede 400 caracteres, o OneDrive não consegue criar ou atualizar o arquivo na pasta de sincronização local, então ele para de sincronizar esse arquivo e exibe o erro.
O erro afeta todos os tipos de arquivo, mas é mais comum em estruturas de pastas profundamente aninhadas, nomes de pastas longos ou arquivos com nomes longos dentro de bibliotecas de documentos do SharePoint sincronizadas via OneDrive. Por exemplo, um arquivo em C:\Usuários\SeuNome\OneDrive - Empresa\Projetos\2025\Campanha Marketing Q1\Ativos\Final\Aprovado\Versão 3\Folder_Campanha_Final_Aprovado_v3_2025_03_15.docx facilmente excede 400 caracteres.
O OneDrive não sincroniza o arquivo até que o caminho seja encurtado. O arquivo permanece na pasta local do OneDrive, mas o status de sincronização mostra um erro. Outros arquivos na mesma pasta continuam sincronizando normalmente.
Etapas para encontrar e corrigir arquivos com caminhos muito longos
- Abra o painel de status de sincronização do OneDrive
Clique com o botão direito no ícone de nuvem do OneDrive na bandeja do sistema, perto do relógio. Selecione Ver problemas de sincronização. Isso abre uma lista de todos os arquivos com erros de sincronização, incluindo o caminho completo de cada arquivo problemático. Anote o local exato da pasta e o nome do arquivo. - Identifique todos os caminhos longos usando a pesquisa do File Explorer
Abra o File Explorer e navegue até sua pasta do OneDrive. Clique na caixa de Pesquisa no canto superior direito. Digite length:>400 e pressione Enter. O File Explorer exibe todos os arquivos cujo caminho completo excede 400 caracteres. Essa pesquisa funciona no Windows 10 e Windows 11. Pode ser necessário aguardar alguns segundos para a pesquisa ser concluída. - Renomeie pastas para encurtar o caminho
Para cada arquivo listado nos resultados da pesquisa, renomeie a pasta mais profunda que tem um nome longo. Use nomes curtos e significativos, como CampQ1 em vez de Campanha Marketing Q1. Evite espaços e caracteres especiais. Após renomear, o caminho do arquivo é encurtado pelo número de caracteres que você removeu. O OneDrive tenta sincronizar novamente automaticamente em alguns minutos. - Mova arquivos para mais perto da raiz da pasta do OneDrive
Se renomear pastas não for suficiente, mova o arquivo para uma pasta de nível superior dentro do seu OneDrive. Por exemplo, mova o arquivo paraOneDrive - Empresa\NomeCurto\em vez de mantê-lo sete níveis de profundidade. Recorte o arquivo e cole no novo local. O OneDrive sincroniza o arquivo a partir do novo caminho. - Use o PowerShell para exportar todos os caminhos longos para edição em lote
Abra o PowerShell como Administrador. Execute este comando para listar todos os arquivos com caminho completo maior que 400 caracteres na sua pasta do OneDrive:Get-ChildItem -Path "C:\Usuários\SeuNome\OneDrive - Empresa" -Recurse -File | Where-Object { $_.FullName.Length -gt 400 } | Select-Object FullName, Length | Export-Csv -Path "C:\Temp\CaminhosLongos.csv" -NoTypeInformation
Abra o arquivo CSV no Excel. Classifique pela coluna FullName. Renomeie ou mova cada arquivo com base na lista. - Verifique o status de sincronização
Após renomear ou mover arquivos, abra novamente o painel de status de sincronização do OneDrive. Confirme se o erro não aparece mais para esses arquivos. Se o erro persistir, verifique se você encurtou o caminho o suficiente. A contagem de caracteres inclui a letra da unidade, todos os nomes de pastas e o nome do arquivo.
Se o OneDrive ainda mostrar o erro de caminho muito longo
Arquivos estão dentro de uma biblioteca de documentos do SharePoint sincronizada via OneDrive
Os nomes das bibliotecas de documentos do SharePoint fazem parte do caminho. Por exemplo, OneDrive - Empresa\Nome do Site SharePoint\Documentos Compartilhados\ adiciona muitos caracteres antes da sua estrutura de pastas. Encurte os nomes das pastas dentro da biblioteca de documentos. Você também pode sincronizar apenas uma subpasta específica em vez de toda a biblioteca. Nas configurações do OneDrive, vá para Sincronizar e backup > Gerenciar backup > Escolher pastas e selecione apenas as pastas necessárias.
A sincronização do OneDrive está travada e não tenta novamente
Se o OneDrive não tentar sincronizar novamente os arquivos corrigidos após 15 minutos, pause e retome a sincronização. Clique com o botão direito no ícone de nuvem do OneDrive e selecione Pausar sincronização por 2 horas. Em seguida, clique em Retomar sincronização. Isso força o OneDrive a reavaliar todos os arquivos.
O caminho do arquivo ainda excede 400 caracteres após renomear
Conte os caracteres no caminho completo. Abra as propriedades do arquivo no File Explorer, copie o caminho completo da guia Segurança ou Detalhes e cole em um editor de texto que mostre a contagem de caracteres. Remova caracteres até que o caminho fique abaixo de 400. Pode ser necessário renomear várias pastas pai ou mover o arquivo para um local mais raso.
| Item | Renomear manualmente no File Explorer | Renomear em lote com PowerShell |
|---|---|---|
| Melhor para | Um ou dois arquivos com caminhos longos | Centenas de arquivos com caminhos longos |
| Tempo necessário | 2 a 5 minutos por arquivo | 10 minutos para escrever e executar o script |
| Risco de perda de dados | Baixo, porque você renomeia arquivos um de cada vez | Médio, se o script renomear os arquivos errados |
| Requer direitos de administrador | Não | Sim, para executar o PowerShell |
Agora você pode encontrar e corrigir arquivos que o OneDrive bloqueia devido a caminhos longos. Da próxima vez que criar uma estrutura de pastas dentro do OneDrive, mantenha os nomes das pastas com menos de 20 caracteres e limite o aninhamento a três níveis. Use a pesquisa length:>400 no File Explorer como uma etapa de manutenção regular para detectar caminhos longos antes que causem erros de sincronização.