Nome de Arquivo Muito Longo Bloqueia uma Biblioteca Corporativa: Solução para OneDrive for Business

Quando um nome de arquivo ou o caminho completo excede os limites de caracteres do Windows ou do OneDrive, o arquivo não sincroniza e bloqueia toda a biblioteca. Esse problema impede o upload de novos arquivos, impede que edições sejam salvas e exibe um erro no status de sincronização do OneDrive. A causa raiz é que o OneDrive for Business impõe um limite de 400 caracteres para o caminho completo do arquivo, incluindo o nome do arquivo. Este artigo explica por que esse limite existe e fornece três métodos para localizar e renomear ou mover os arquivos que estão bloqueando.

Por que o OneDrive Bloqueia Arquivos com Caminhos Longos

O OneDrive for Business usa o sistema de arquivos NTFS no Windows, que tem um comprimento máximo de caminho de 32.767 caracteres para aplicativos que habilitam o suporte a caminhos longos. No entanto, o próprio OneDrive impõe um limite mais restrito de 400 caracteres para o caminho completo, incluindo o nome do arquivo. Esse limite se aplica ao comprimento combinado da letra da unidade, estrutura de pastas e nome do arquivo. Quando qualquer arquivo ou pasta em uma biblioteca sincronizada excede esse limite, o OneDrive para de sincronizar esse arquivo e todos os arquivos na mesma hierarquia de pastas. A biblioteca então mostra um estado de erro, e os usuários não podem fazer upload, editar ou excluir arquivos até que o arquivo bloqueador seja resolvido. O limite existe para manter o desempenho durante as operações de sincronização e para evitar problemas quando os arquivos são acessados em outras plataformas ou através do SharePoint Online, que também impõe um limite de 400 caracteres para URLs.

Como o Limite de 400 Caracteres é Calculado

O limite de 400 caracteres inclui o caminho da pasta local no seu computador mais o nome do arquivo. Por exemplo, se sua pasta do OneDrive estiver localizada em C:\Users\SeuNome\OneDrive – Contoso, esse prefixo tem 38 caracteres. Uma estrutura de pastas abaixo desse caminho como Projetos\2025\Q1\Entregas do Cliente adiciona mais 40 caracteres. Se o nome do arquivo em si tiver 330 caracteres, o total excede 400 e o arquivo não será sincronizado. O SharePoint Online tem um limite semelhante de 400 caracteres para o caminho da URL. Isso significa que os arquivos que sincronizam do SharePoint para o OneDrive também estão sujeitos a essa restrição.

Passos para Encontrar e Corrigir o Arquivo Bloqueador

Os métodos a seguir ajudam a localizar o arquivo com o caminho longo e, em seguida, renomeá-lo ou movê-lo para que o OneDrive possa retomar a sincronização.

Método 1: Usar a Mensagem de Erro do OneDrive

1. Abra o status de sincronização do OneDrive
   Clique no ícone de nuvem do OneDrive na bandeja do sistema, perto do relógio. Se você vir um círculo vermelho com um X branco, passe o mouse sobre ele. Uma mensagem pop-up exibe o nome do arquivo e o erro: “O nome do arquivo é muito longo” ou “O caminho é muito longo.”
2. Anote o caminho completo do arquivo
   A mensagem de erro mostra o caminho relativo a partir da raiz do seu OneDrive. Escreva a pasta e o nome do arquivo exatamente como mostrado. Este é o arquivo que bloqueia a biblioteca.
3. Navegue até o arquivo no Explorador de Arquivos
   Abra o Explorador de Arquivos e vá para sua pasta do OneDrive. Use o caminho da mensagem de erro para localizar o arquivo. Se o caminho da pasta for longo, talvez seja necessário expandir cada subpasta manualmente.
4. Renomeie ou mova o arquivo
   Clique com o botão direito no arquivo e selecione Renomear. Encurte o nome do arquivo para menos de 100 caracteres. Como alternativa, mova o arquivo para uma pasta de nível superior para reduzir o comprimento do caminho. Após a alteração, o OneDrive retoma a sincronização em alguns segundos.

Método 2: Classificar Arquivos por Comprimento do Caminho no Explorador de Arquivos

1. Abra sua pasta do OneDrive
   Pressione a tecla Windows + E para abrir o Explorador de Arquivos. Navegue até a localização da sua pasta do OneDrive, normalmente C:\Users\SeuNome\OneDrive – NomeDaEmpresa.
2. Adicione a coluna Caminho
   Clique com o botão direito em qualquer cabeçalho de coluna, como Nome ou Data de modificação. Clique em Mais. Na caixa de diálogo Escolher Detalhes, role para baixo, marque a caixa Caminho e clique em OK. A coluna Caminho agora mostra o caminho completo para cada arquivo.
3. Classifique pelo comprimento do Caminho
   Clique no cabeçalho da coluna Caminho para classificar os arquivos alfabeticamente pelo caminho. Arquivos em pastas mais profundas aparecem perto do final. Verifique manualmente os arquivos com caminhos muito longos. Um caminho maior que 400 caracteres aparecerá como uma string muito longa na coluna Caminho.
4. Renomeie ou mova os arquivos identificados
   Para cada arquivo com um caminho excessivamente longo, clique com o botão direito e selecione Renomear. Encurte o nome para menos de 50 caracteres. Se vários arquivos compartilham um caminho de pasta longo, considere mover a pasta inteira para um nível superior na estrutura do OneDrive.

Método 3: Usar PowerShell para Listar Arquivos com Caminho Longo

1. Abra o PowerShell como administrador
   Pressione a tecla Windows, digite PowerShell, clique com o botão direito em Windows PowerShell e selecione Executar como administrador. Clique em Sim no prompt de Controle de Conta de Usuário.
2. Execute o comando Get-ChildItem
   Digite o seguinte comando e pressione Enter:
   Get-ChildItem -Path "C:\Users\SeuNome\OneDrive - NomeDaEmpresa" -Recurse | Where-Object { $_.FullName.Length -gt 400 } | Select-Object FullName
   Substitua o caminho pela localização real da sua pasta do OneDrive. Este comando lista todos os arquivos cujo caminho completo excede 400 caracteres.
3. Revise a saída
   A janela do PowerShell exibe o caminho completo de cada arquivo que excede o limite. Copie cada caminho para o Bloco de Notas para referência.
4. Renomeie ou mova cada arquivo
   Para cada arquivo na lista, navegue até sua localização no Explorador de Arquivos. Encurte o nome do arquivo ou mova o arquivo para uma pasta mais rasa. Após fazer as alterações, execute o comando PowerShell novamente para confirmar que nenhum arquivo permanece com mais de 400 caracteres.

Se o OneDrive Ainda Mostrar um Erro Após a Correção Principal

Após renomear ou mover o arquivo bloqueador, o OneDrive ainda pode exibir um erro. Os cenários a seguir explicam por que e como resolvê-los.

OneDrive Mostra um X Vermelho no Ícone da Pasta

Um X vermelho em uma pasta em vez de um arquivo significa que o nome da pasta em si é muito longo. O caminho combinado da hierarquia de pastas excede 400 caracteres mesmo antes de adicionar nomes de arquivos. Para corrigir isso, renomeie a pasta para um nome mais curto ou mova-a para um nível superior na estrutura do OneDrive. Por exemplo, altere “2025 Campanha de Marketing Rascunhos Q1 Revisão Final” para “2025-Marketing-Q1”. Após renomear a pasta, todos os arquivos dentro dela serão sincronizados normalmente.

OneDrive Para de Sincronizar a Biblioteca Inteira

Se o OneDrive parar de sincronizar a biblioteca inteira depois que você corrigir um arquivo, pode existir um segundo arquivo com caminho longo em uma estrutura de pastas mais profunda. Execute o comando PowerShell do Método 3 novamente para verificar se há arquivos adicionais. Repita as etapas de renomear ou mover para cada arquivo até que o comando não retorne resultados. Após corrigir o último arquivo, o OneDrive retoma a sincronização de toda a biblioteca.

A Mensagem de Erro do OneDrive Diz que o Nome do Arquivo Contém Caracteres Inválidos

Alguns arquivos com nomes longos também contêm caracteres que o Windows ou o SharePoint não permitem, como “, :, /, \, |, <, > ou ?. Se a mensagem de erro mencionar caracteres inválidos além do comprimento, renomeie o arquivo para remover esses caracteres. Use apenas letras, números, espaços, hífens, sublinhados e pontos. Após remover os caracteres inválidos, o arquivo sincroniza desde que o caminho total esteja abaixo de 400 caracteres.

Item	OneDrive for Business	SharePoint Online
Comprimento máximo do caminho	400 caracteres	400 caracteres
Comprimento máximo do nome do arquivo	255 caracteres	255 caracteres
Caracteres inválidos no nome do arquivo	~ # % & : < > ? / \ { | }	~ # % & : < > ? / \ { | }
Comportamento de sincronização quando o limite é excedido	Arquivo não enviado; erro exibido no status de sincronização	Arquivo não enviado; erro exibido na biblioteca
Método de correção	Renomear ou mover o arquivo localmente; a alteração sincroniza automaticamente	Renomear ou mover o arquivo no navegador; a alteração sincroniza com o OneDrive

Após renomear ou mover o arquivo bloqueador, o OneDrive retoma automaticamente a sincronização de toda a biblioteca. Para evitar esse erro no futuro, defina uma convenção de nomenclatura que mantenha os nomes dos arquivos com menos de 100 caracteres e limite a profundidade das pastas a cinco níveis. Se sua equipe trabalha frequentemente com estruturas de pastas profundas, use o comando PowerShell como uma verificação semanal para identificar caminhos longos antes que eles bloqueiem a biblioteca.