Ferramenta de Migração do SharePoint Ignora Arquivos com Caminho Longo: Causa e Solução

Ao migrar arquivos para o SharePoint usando a Ferramenta de Migração, alguns podem ser ignorados sem um erro óbvio. O log de migração mostra um aviso de que o caminho do arquivo excede 400 caracteres. Isso acontece porque o Windows e o SharePoint impõem um limite máximo de comprimento de caminho que a ferramenta respeita. Este artigo explica por que a Ferramenta de Migração do SharePoint ignora arquivos com caminho longo e fornece uma solução para resolver o problema.

Por que a Ferramenta de Migração do SharePoint Ignora Arquivos com Caminhos Longos

A Ferramenta de Migração do SharePoint usa a API do sistema de arquivos do Windows para ler os arquivos de origem. Por padrão, o Windows tem um comprimento máximo de caminho de 260 caracteres, conhecido como MAX_PATH. Esse limite se aplica ao caminho total desde a letra da unidade até o nome do arquivo, incluindo barras invertidas. Quando um caminho de arquivo excede 260 caracteres, a API do Windows não consegue acessar o arquivo e o SPMT o ignora.

O SharePoint Online suporta caminhos de até 400 caracteres em uma biblioteca de documentos. No entanto, a ferramenta de migração precisa primeiro ler o arquivo da origem local. Se o caminho de origem for maior que 260 caracteres, a ferramenta não consegue abrir o arquivo para fazer o upload. O log de migração registra um aviso com a mensagem “O caminho do arquivo é muito longo” e o arquivo é ignorado.

Essa limitação não é um bug no SPMT. É uma restrição do sistema de arquivos subjacente do Windows. O mesmo problema ocorre ao tentar copiar, mover ou excluir um arquivo com caminho maior que 260 caracteres no Explorador de Arquivos. A correção exige habilitar o suporte a caminhos longos no Windows ou encurtar a estrutura de pastas de origem antes da migração.

Passos para Corrigir o Problema de Ignoração de Arquivos com Caminho Longo

Existem dois métodos para resolver esse problema. O Método 1 habilita o suporte a caminhos longos na máquina Windows onde o SPMT é executado. O Método 2 reduz a profundidade das pastas na unidade de origem. Use o Método 1 se não puder alterar a estrutura de pastas de origem. Use o Método 2 se preferir evitar alterações no registro.

Método 1: Habilitar Suporte a Caminhos Longos no Windows

1. Abra o Editor de Registro
   Pressione a tecla Windows + R, digite regedit e pressione Enter. Clique em Sim se solicitado pelo Controle de Conta de Usuário.
2. Navegue até a chave LongPathsEnabled
   No painel esquerdo, vá para HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem. Role para baixo até encontrar a entrada LongPathsEnabled.
3. Modifique o valor para 1
   Clique duas vezes em LongPathsEnabled. Altere os Dados do valor de 0 para 1. Clique em OK.
4. Reinicie o computador
   Feche o Editor de Registro e reinicie o computador. Essa alteração habilita o suporte a caminhos longos para todos os aplicativos que optarem por isso, incluindo o SPMT.
5. Execute o SPMT novamente
   Abra a Ferramenta de Migração do SharePoint e inicie a mesma tarefa de migração. Arquivos com caminhos de até 32.767 caracteres agora podem ser lidos e carregados.

Método 2: Encurtar a Estrutura de Pastas de Origem

1. Identifique pastas com aninhamento profundo
   Abra a pasta de origem no Explorador de Arquivos. Procure pastas aninhadas com mais de 5 níveis de profundidade. Cada nível de pasta aumenta o comprimento do caminho.
2. Mova os arquivos para uma pasta raiz mais curta
   Crie uma nova pasta diretamente na raiz da unidade, por exemplo C:\Migrar. Copie os arquivos e pastas do local profundo para esta nova pasta. Isso reduz o comprimento inicial do caminho.
3. Renomeie pastas para nomes mais curtos
   Se não for possível mover os arquivos, renomeie as pastas para caracteres únicos ou números. Por exemplo, renomeie “Departamento de Finanças e Contabilidade” para “FinCont”. Isso reduz o comprimento total do caminho.
4. Remova pastas intermediárias desnecessárias
   Exclua pastas que não servem para nada, como “Arquivo” ou “Antigo” dentro de uma estrutura profunda. Combine várias pastas vazias em uma só.
5. Execute o SPMT com o caminho de origem encurtado
   Aponte o SPMT para o novo local de pasta mais curto. Verifique se nenhum arquivo é ignorado devido ao comprimento do caminho.

Se a Ferramenta de Migração Ainda Ignorar Arquivos Após a Correção

Log do SPMT Mostra que o Caminho do Arquivo Ainda é Muito Longo

Se você aplicou o Método 1 mas os arquivos ainda são ignorados, confirme se a alteração no registro surtiu efeito. Abra o Editor de Registro novamente e verifique se LongPathsEnabled está definido como 1. Além disso, certifique-se de ter reiniciado o computador após a alteração. Algumas versões antigas do SPMT podem não suportar caminhos longos. Atualize o SPMT para a versão mais recente no Centro de Download da Microsoft.

Nome do Arquivo Contém Caracteres Inválidos

Um arquivo com comprimento de caminho válido ainda pode ser ignorado se seu nome contiver caracteres que o SharePoint não permite. Caracteres inválidos incluem ~ # % & : < > ? / \ |. Renomeie o arquivo na origem para remover esses caracteres antes de executar o SPMT novamente.

SPMT Relata Acesso Negado ao Arquivo

Se o caminho do arquivo for curto o suficiente, mas o SPMT não conseguir ler o arquivo, verifique as permissões do arquivo. Clique com o botão direito no arquivo, selecione Propriedades, vá para a guia Segurança e verifique se sua conta tem permissão de Leitura. Caso contrário, assuma a propriedade do arquivo ou peça ao administrador para conceder acesso.

Item	Alteração no Registro (Método 1)	Reestruturação de Pastas (Método 2)
Efeito nos arquivos de origem	Nenhum	Move ou renomeia arquivos
Requer direitos de administrador	Sim	Não
Requer reinicialização	Sim	Não
Funciona para todas as migrações futuras	Sim	Não
Risco de quebrar outros aplicativos	Baixo	Nenhum

Agora você pode executar a Ferramenta de Migração do SharePoint sem que arquivos sejam ignorados devido a caminhos longos. Se você habilitou a alteração no registro, lembre-se de definir LongPathsEnabled de volta para 0 após a migração se não precisar do suporte a caminhos longos para outros aplicativos. Para migrações contínuas, considere usar a Ferramenta de Migração do SharePoint com scripts do PowerShell que incluam uma verificação de comprimento de caminho antes da transferência.