Após migrar arquivos para o OneDrive for Business, você pode ver um erro de “caminho muito longo”. Isso ocorre porque o Windows e o OneDrive têm um limite de 260 caracteres no caminho. Arquivos com estruturas de pastas profundas ou nomes longos excedem esse limite durante ou após a migração.
A causa raiz é que a ferramenta de migração copia o caminho completo da origem. Se a origem tinha pastas aninhadas, o comprimento combinado do caminho no OneDrive pode facilmente exceder 260 caracteres. O OneDrive então falha ao sincronizar o arquivo e exibe o erro.
Este artigo explica como identificar arquivos com caminhos muito longos, encurtá-los usando ferramentas nativas do Windows e evitar que o erro ocorra novamente. Você aprenderá dois métodos para corrigir o problema sem software de terceiros.
Principais Conclusões: Corrigindo Erros de Caminho Muito Longo Após Migração
- PowerShell Get-ChildItem com -Recurse e -Name: Lista todos os arquivos cujo caminho completo excede 260 caracteres em uma pasta específica.
- Renomear ou mover no File Explorer: Encurte nomes de pastas ou mova arquivos para um nível de pasta mais raso para reduzir o comprimento do caminho.
- OneDrive Known Folder Move: Evita o erro mapeando Documentos, Área de Trabalho e Imagens diretamente para o OneDrive em um caminho base curto.
Por que o Erro de Caminho Muito Longo Ocorre Após a Migração
O Windows e o sistema de arquivos NTFS historicamente limitam um caminho completo de arquivo a 260 caracteres. Esse limite inclui a letra da unidade, dois-pontos, barras invertidas, nomes de pastas e o nome do arquivo com extensão. O OneDrive for Business aplica o mesmo limite ao sincronizar arquivos.
Durante uma migração, os arquivos são copiados de uma origem, como uma unidade local, um compartilhamento de rede ou outro serviço de nuvem. Se a origem tinha pastas aninhadas em mais de cinco ou seis níveis, ou se os nomes das pastas são longos, o caminho resultante no OneDrive pode exceder 260 caracteres. Por exemplo, um arquivo em C:\Usuários\João\Documentos\Projetos\2025\Q1\NomeCliente\Proposta\VersãoFinal\v3\relatorio.docx já usa 98 caracteres antes de ser colocado no OneDrive. Quando movido para C:\Usuários\João\OneDrive - Contoso\Documentos\Projetos\2025\Q1\NomeCliente\Proposta\VersãoFinal\v3\relatorio.docx, o caminho cresce para mais de 140 caracteres. Se o caminho de origem já estava perto de 200 caracteres, o caminho do OneDrive excederá 260.
A Microsoft removeu o limite de 260 caracteres no Windows 10 versão 1607 e posteriores para aplicativos que optam por isso. No entanto, o OneDrive não oferece suporte nativo a caminhos longos. O erro aparece como uma notificação no centro de atividades do OneDrive: “Caminho muito longo” ou “O nome de arquivo especificado não é válido ou é muito longo.” O arquivo permanece na pasta local do OneDrive, mas não sincroniza com a nuvem.
Passos para Identificar e Corrigir Arquivos com Caminhos Excedendo 260 Caracteres
Você usará o PowerShell para verificar arquivos com caminhos maiores que 260 caracteres. Em seguida, encurtará os caminhos usando o File Explorer ou um script. Estas etapas pressupõem que você já migrou os arquivos para a pasta local do OneDrive.
- Abra o PowerShell como Administrador
Pressione a tecla Windows, digite PowerShell, clique com o botão direito em Windows PowerShell nos resultados da pesquisa e selecione Executar como administrador. Clique em Sim no prompt de Controle de Conta de Usuário. - Navegue até a pasta do OneDrive
No PowerShell, digitecd $env:OneDrivee pressione Enter. Isso altera o diretório atual para sua pasta do OneDrive. Se essa variável não estiver definida, digitecd "C:\Usuários\SeuNome\OneDrive - Contoso"com seu nome de usuário e nome da organização reais. - Execute o script PowerShell para listar caminhos longos
Copie e cole o seguinte comando no PowerShell e pressione Enter:Get-ChildItem -Recurse -Name | Where-Object { $_.Length -gt 260 } | Out-File -FilePath "$env:USERPROFILE\Desktop\CaminhosLongos.txt"
Este comando verifica todos os arquivos e pastas recursivamente. Ele grava os caminhos relativos completos dos itens que excedem 260 caracteres em um arquivo de texto na sua área de trabalho chamado CaminhosLongos.txt. A verificação pode levar vários minutos, dependendo do número de arquivos. - Abra o arquivo CaminhosLongos.txt
Navegue até sua área de trabalho e abra CaminhosLongos.txt no Bloco de Notas ou em qualquer editor de texto. Cada linha mostra um caminho relativo a partir da raiz do OneDrive. Revise a lista para entender quais pastas contêm os caminhos mais longos. - Encurte nomes de pastas ou reestruture pastas
Abra o File Explorer e vá para a pasta do OneDrive. Para cada pasta listada no CaminhosLongos.txt, faça o seguinte:
– Renomeie subpastas profundas para nomes mais curtos. Por exemplo, renomeieVersãoFinalparaVFePropostaparaProp.
– Mova arquivos de pastas profundas para um nível superior. Por exemplo, movarelatorio.docxdeProposta\VersãoFinal\v3diretamente paraProposta.
– Exclua pastas vazias ou redundantes. Clique com o botão direito em uma pasta e selecione Excluir se ela não contiver arquivos. - Execute novamente o script PowerShell para verificar
Após fazer as alterações, execute o comando Get-ChildItem novamente. Se o arquivo CaminhosLongos.txt estiver vazio ou não contiver novas entradas, todos os caminhos estão agora abaixo de 260 caracteres. - Reinicie a sincronização do OneDrive
Clique com o botão direito no ícone de nuvem do OneDrive na bandeja do sistema e selecione Pausar sincronização por 2 horas. Em seguida, clique com o botão direito novamente e selecione Retomar sincronização. O OneDrive reexaminará a pasta e enviará os arquivos anteriormente bloqueados.
Se o OneDrive Ainda Mostrar o Erro Após Encurtar os Caminhos
Arquivos não estão na pasta esperada do OneDrive
Se você encurtou os caminhos, mas o erro persiste, verifique se os arquivos estão realmente dentro da pasta do OneDrive. Abra o File Explorer e confira o caminho na barra de endereços. Deve começar com C:\Usuários\SeuNome\OneDrive - SuaOrg\. Se os arquivos estiverem fora desta pasta, mova-os manualmente para a pasta do OneDrive.
A ferramenta de migração criou nomes de pastas com caracteres especiais
Algumas ferramentas de migração anexam timestamps ou GUIDs aos nomes das pastas. Isso pode adicionar 30 a 40 caracteres a um caminho. Renomeie essas pastas para remover os caracteres extras. Por exemplo, renomeie ProjetoX_20250315_142305 para ProjetoX.
A sincronização do OneDrive está travada em um arquivo diferente
Um único arquivo com caminho longo pode bloquear toda a fila de sincronização. Se o erro mostrar um nome de arquivo diferente após sua correção, repita a verificação com PowerShell e o encurtamento para esse novo arquivo. Continue até que o arquivo CaminhosLongos.txt esteja vazio.
Arquivos Sob Demanda vs Manter Sempre Neste Dispositivo: Efeito nos Erros de Caminho Longo
| Item | Arquivos Sob Demanda | Manter Sempre Neste Dispositivo |
|---|---|---|
| Descrição | Arquivos são exibidos como placeholders somente online até serem abertos | Arquivos são baixados e mantidos localmente o tempo todo |
| Limite de comprimento do caminho | 260 caracteres para o caminho do placeholder local | 260 caracteres para o caminho do arquivo local |
| Efeito no erro | O erro ainda ocorre porque o caminho do placeholder está sujeito ao mesmo limite | O erro ainda ocorre porque o caminho completo é gravado no disco |
| Configuração recomendada durante a migração | Desative Arquivos Sob Demanda para forçar o download completo e detectar erros de caminho cedo | Use esta configuração após encurtar os caminhos para garantir que todos os arquivos sincronizem |
Depois de encurtar todos os caminhos, você pode reativar Arquivos Sob Demanda. Clique com o botão direito no ícone de nuvem do OneDrive, selecione Configurações, vá para a guia Sincronizar e fazer backup e, em Arquivos Sob Demanda, marque Economizar espaço e baixar arquivos conforme você os usa.
Agora você pode verificar sua pasta do OneDrive em busca de arquivos com caminhos que excedem 260 caracteres usando o PowerShell e encurtá-los manualmente. Para evitar esse erro em migrações futuras, use uma estrutura de pastas com no máximo quatro níveis de profundidade e mantenha os nomes das pastas com menos de 20 caracteres. Para proteção contínua, habilite a política de suporte a caminhos longos do Windows no Grupo de Políticas em Configuração do Computador > Modelos Administrativos > Sistema > Sistema de Arquivos > Habilitar caminhos longos do Win32, embora o OneDrive ainda aplique seu próprio limite.