Ferramenta de Migração do SharePoint Ignora Arquivos com Caminhos Longos: Correção

Ao executar a Ferramenta de Migração do SharePoint, alguns arquivos podem ser ignorados sem erro claro. Isso ocorre porque o Windows tem um limite de 260 caracteres no caminho, que a ferramenta aplica por padrão. Arquivos com caminhos maiores que 260 caracteres não são movidos para o SharePoint ou OneDrive. Este artigo explica por que a ferramenta ignora esses arquivos e como corrigir o problema usando edições no registro e configurações do SPMT.

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 Windows para ler arquivos. Por padrão, o Windows limita os caminhos de arquivo a 260 caracteres. Esse limite inclui a letra da unidade, dois pontos, barra invertida, pastas e nome do arquivo. Qualquer arquivo com caminho maior que 260 caracteres fica invisível para a ferramenta de migração, sendo ignorado.

Esse limite existe na API Win32, usada por muitos aplicativos. A Microsoft introduziu uma configuração de registro no Windows 10 versão 1607 e Windows 11 para desabilitar esse limite. A configuração não está ativada por padrão. Quando o limite está ativo, a Ferramenta de Migração do SharePoint não consegue acessar o arquivo, e o log de migração mostra uma entrada de ignorado sem código de erro.

Como Caminhos Longos Afetam a Migração do SharePoint

O SharePoint em si suporta caminhos de até 400 caracteres. Mas a ferramenta de migração é executada na máquina de origem com o limite do Windows. Mesmo que o SharePoint possa armazenar o arquivo, a ferramenta não consegue lê-lo da origem. Essa incompatibilidade faz com que os arquivos sejam ignorados silenciosamente. O relatório de migração mostra o arquivo como ignorado, mas nem sempre explica o motivo.

Passos para Habilitar o Suporte a Caminhos Longos no Computador de Origem

Para corrigir esse problema, você deve habilitar o suporte a caminhos longos no computador Windows onde a Ferramenta de Migração do SharePoint é executada. Existem dois métodos: editar o registro diretamente ou usar a Política de Grupo. Ambos os métodos exigem direitos de administrador.

Método 1: Editar o Registro do Windows

1. Abra o Editor de Registro
   Pressione Windows + R, digite regedit e pressione Enter. Se solicitado pelo Controle de Conta de Usuário, clique em Sim.
2. Navegue até a Chave de Caminhos Longos
   Vá para HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem.
3. Modifique o Valor LongPathsEnabled
   Clique duas vezes em LongPathsEnabled. Se o valor não existir, clique com o botão direito no painel direito, selecione Novo > Valor DWORD (32 bits) e nomeie como LongPathsEnabled. Defina os dados do valor como 1 e clique em OK.
4. Reinicie o Computador
   Feche o Editor de Registro e reinicie o computador para que a alteração entre em vigor.

Método 2: Usar a Política de Grupo

1. Abra o Editor de Política de Grupo Local
   Pressione Windows + R, digite gpedit.msc e pressione Enter.
2. Navegue até a Política de Sistema de Arquivos
   Vá para Configuração do Computador > Modelos Administrativos > Sistema > Sistema de Arquivos.
3. Habilite Caminhos Longos Win32
   Clique duas vezes em Habilitar caminhos longos Win32. Selecione Habilitado e clique em OK.
4. Reinicie o Computador
   Feche o Editor de Política de Grupo e reinicie o computador.

Configurar a Ferramenta de Migração do SharePoint para Usar Caminhos Longos

Após habilitar o suporte a caminhos longos no Windows, você também deve configurar a Ferramenta de Migração do SharePoint para incluir arquivos com caminhos longos.

1. Abra a Ferramenta de Migração do SharePoint
   Inicie o SPMT pelo menu Iniciar ou pelo centro de administração do Microsoft 365.
2. Inicie uma Nova Migração
   Clique em Iniciar e escolha sua origem e destino.
3. Abra as Configurações Avançadas
   Na tela de configuração da migração, clique em Configurações Avançadas.
4. Habilite o Suporte a Caminhos Longos
   Role até a seção Suporte a caminhos longos. Ative a alternância para Ligado. Isso informa ao SPMT para incluir arquivos com caminhos maiores que 260 caracteres.
5. Execute a Migração
   Clique em Iniciar para começar a migração. O SPMT agora processará arquivos com caminhos longos.

Se os Arquivos Ainda Forem Ignorados Após a Correção

Mesmo após habilitar o suporte a caminhos longos, alguns arquivos ainda podem ser ignorados. Aqui estão os motivos mais comuns e como corrigi-los.

Limite de Caminho do SharePoint Excedido

O SharePoint suporta caminhos de até 400 caracteres. Se o caminho do arquivo de origem for maior que 400 caracteres, o SharePoint o rejeitará. Encurte a estrutura de pastas na origem antes de migrar. Renomeie pastas profundamente aninhadas para reduzir o comprimento total do caminho.

Nome do Arquivo Contém Caracteres Inválidos

O SharePoint não permite certos caracteres em nomes de arquivo: " : < > ? / \ |. Se um nome de arquivo contiver algum desses, a ferramenta de migração o ignora. Renomeie os arquivos na origem antes de iniciar a migração.

Versão da Ferramenta de Migração Desatualizada

Versões antigas do SPMT podem não ter a configuração de suporte a caminhos longos. Baixe a versão mais recente do centro de administração do Microsoft 365. Vá para Migração > Ferramenta de Migração do SharePoint > Baixar.

Comparação de Configurações do SPMT: Padrão vs. Caminho Longo Habilitado

Item	Configuração Padrão	Caminho Longo Habilitado
Limite de caminho do arquivo	260 caracteres	Até 32.767 caracteres (limite do Windows)
Alteração no registro necessária	Não	Sim, LongPathsEnabled = 1
Configuração do SPMT	Desligado	Ligado nas Configurações Avançadas
Arquivos ignorados	Todos os arquivos com caminhos acima de 260 caracteres	Apenas arquivos com caminhos acima de 400 caracteres ou nomes inválidos
Reinicialização necessária	Não	Sim, após alteração no registro

A Ferramenta de Migração do SharePoint ignora arquivos com caminhos longos porque o Windows impõe um limite de 260 caracteres por padrão. Você pode corrigir isso habilitando a chave de registro LongPathsEnabled e ativando a configuração de suporte a caminhos longos no SPMT. Após essas alterações, a ferramenta migrará arquivos com caminhos maiores que 260 caracteres, embora o SharePoint ainda imponha um limite de 400 caracteres. Para ambientes corporativos, use a Política de Grupo para aplicar a alteração do registro em vários computadores de uma vez. Sempre verifique o log de migração em busca de arquivos ignorados após a correção para confirmar que não há outros problemas.