Ao executar uma migração com a Ferramenta de Migração do SharePoint, alguns arquivos podem ser ignorados com o erro “caminho muito longo”. Isso acontece porque o Windows e o SharePoint têm um limite de 400 caracteres para o caminho completo do arquivo, incluindo o nome do arquivo. Se algum arquivo exceder esse limite, a Ferramenta de Migração do SharePoint o ignorará e registrará como uma falha. Este artigo explica por que arquivos com caminho longo são ignorados, como identificá-los antes da migração e as etapas exatas para corrigir os caminhos para que todos os arquivos sejam transferidos com sucesso.
Principais Conclusões: Como Corrigir Arquivos com Caminho Longo na Migração do SharePoint
- Ferramenta de Migração do SharePoint > Relatório de verificação: Revise o relatório de verificação antes de iniciar a migração para ver quais arquivos excedem o limite de comprimento do caminho.
- Windows 10/11 Habilitar Caminhos Longos: Habilitar o suporte a caminhos longos na Política de Grupo do Windows não altera o limite de 400 caracteres do SharePoint.
- Encurtar nomes de pastas ou reestruturar: A única correção confiável é renomear pastas profundas ou mover arquivos para uma estrutura de pastas mais rasa.
Por que a Ferramenta de Migração do SharePoint Ignora Arquivos com Caminho Longo
A Ferramenta de Migração do SharePoint usa a API REST do SharePoint, que impõe um comprimento máximo de URL de 400 caracteres para o caminho da biblioteca de documentos e o nome do arquivo combinados. Esse limite se aplica ao caminho completo da URL após a URL do conjunto de sites. Por exemplo, se a URL do seu site for https://contoso.sharepoint.com/sites/marketing, o caminho restante para a biblioteca de documentos e o arquivo não pode exceder 400 caracteres.
Ao migrar arquivos de um servidor de arquivos local ou compartilhamento de rede, a ferramenta mapeia a estrutura de pastas local para a biblioteca de documentos do SharePoint. Se algum caminho de pasta local mais o nome do arquivo exceder 400 caracteres, a ferramenta sinaliza o arquivo como “caminho muito longo” e o ignora. A ferramenta não truncará ou renomeará caminhos automaticamente. Você deve corrigir isso antes ou durante a migração.
O que Conta para o Limite de 400 Caracteres
O limite de 400 caracteres inclui:
- O nome da biblioteca de documentos (por exemplo,
Shared Documents) - Todos os nomes de pastas no caminho
- O nome do arquivo, incluindo a extensão
- Espaços e caracteres especiais (cada um conta como um caractere)
A URL do conjunto de sites e a parte /sites/ não estão incluídas nesta contagem. Apenas o caminho a partir da raiz da biblioteca de documentos é medido.
Etapas para Identificar e Corrigir Arquivos com Caminho Longo Antes da Migração
- Execute uma verificação com a Ferramenta de Migração do SharePoint
Abra a Ferramenta de Migração do SharePoint no centro de administração do Microsoft 365 ou baixe a versão para desktop. Crie um novo trabalho de migração e selecione sua pasta de origem. Antes de clicar em Migrar, clique em Verificar. A ferramenta gera um relatório que lista todos os arquivos que serão ignorados devido a caminhos longos. - Revise o relatório de verificação
Abra o relatório de verificação no seu navegador. Procure pela guia Problemas. Arquivos com caminho maior que 400 caracteres aparecem com o código de erroPathTooLong. Anote o caminho local completo de cada arquivo. Você pode exportar o relatório para CSV para facilitar a análise. - Encurte os nomes das pastas no local de origem
Renomeie pastas profundas para nomes mais curtos. Por exemplo, renomeie2025-Q1-Campanhas-Q1-2025-Revisoes-Finaispara2025-Q1-Final. Isso reduz o comprimento total do caminho. Faça isso no servidor de arquivos de origem antes de executar a migração novamente. - Reestruture a hierarquia de pastas
Se encurtar os nomes das pastas não for suficiente, mova os arquivos de subpastas profundas para um nível mais alto. Por exemplo, em vez deProjetos > ClienteA > 2025 > Entregaveis > Final, useClienteA-2025-Finalcomo um único nome de pasta. Isso reduz o número de segmentos do caminho. - Use a Ferramenta de Migração do SharePoint com a opção SkipLongPaths
Se você não puder corrigir todos os caminhos longos manualmente, pode configurar a ferramenta para ignorá-los automaticamente. Nas configurações da ferramenta, habilite Ignorar arquivos com caminho maior que 400 caracteres. A ferramenta ignorará esses arquivos e continuará a migração sem parar. Você precisará migrar os arquivos ignorados separadamente após corrigir seus caminhos. - Execute a migração novamente
Após renomear pastas ou reestruturar, execute a verificação novamente para confirmar que nenhum arquivo excede o limite. Em seguida, inicie a migração. A ferramenta carregará todos os arquivos que agora têm caminhos válidos.
Se a Ferramenta de Migração do SharePoint Ainda Ignorar Arquivos Após Corrigir os Caminhos
Arquivos com caracteres especiais no caminho
A Ferramenta de Migração do SharePoint também pode ignorar arquivos se o caminho contiver caracteres que o SharePoint não permite. Estes incluem ~ # % & { } \ : < > ? | ". Verifique o relatório de verificação para o código de erro InvalidFileName. Renomeie o arquivo ou pasta para remover esses caracteres.
Nomes de arquivo que terminam com espaço ou ponto
O Windows permite que nomes de arquivo terminem com espaço ou ponto, mas o SharePoint não. A ferramenta de migração ignorará esses arquivos com o código de erro InvalidFileName. Renomeie o arquivo para remover o espaço ou ponto final antes de executar a migração novamente.
Caminho de rede vs caminho local
Se você estiver migrando de um compartilhamento de rede, o comprimento do caminho inclui o caminho UNC completo como \\servidor\compartilhamento\pasta\arquivo.docx. Esse caminho é tipicamente mais longo que o caminho da unidade local. Considere mapear o compartilhamento de rede para uma letra de unidade como Z:\pasta\arquivo.docx. Isso reduz o comprimento do caminho para a verificação. No entanto, o limite de caminho do SharePoint ainda se aplica após o mapeamento.
| Item | Caminho da Unidade Local | Caminho do Compartilhamento de Rede |
|---|---|---|
| Exemplo de caminho | C:\Dados\Projetos\Arquivo.docx | \\servidorarquivos\compartilhamento\Projetos\Arquivo.docx |
| Contagem de caracteres | Aproximadamente 25 caracteres | Aproximadamente 40 caracteres |
| Risco de exceder o limite | Menor | Maior |
Depois de corrigir todos os arquivos com caminho longo e executar a migração novamente, todos os arquivos devem ser transferidos com sucesso. A Ferramenta de Migração do SharePoint registra o status de cada arquivo no histórico de migração. Você pode verificar se nenhum arquivo foi ignorado verificando a guia Concluído na ferramenta após o término do trabalho.
Para migrações futuras, planeje sua estrutura de pastas para manter os caminhos abaixo de 400 caracteres. Use nomes de pastas curtos e evite aninhar pastas com mais de cinco níveis de profundidade. Isso evita problemas de comprimento de caminho desde o início.