M365Con 2027 – conferência online gratuita · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Limites de comprimento de caminho e de nome de arquivo no SharePoint: corrija antes de migrar

By · · Updated

O limite de comprimento da URL do SharePoint é de 400 caracteres para o caminho decodificado do arquivo. Encontre caminhos longos e nomes inválidos antes de migrar, com este checklist.

Automatically translated with AI from the original post. Read the English original

O limite de comprimento da URL do SharePoint é de 400 caracteres para o caminho decodificado do arquivo, incluindo o nome do arquivo. Caminhos maiores que isso falham no upload, na cópia ou na sincronização, e o usuário vê um erro em vez do arquivo. Este checklist é para líderes de uma migração para o SharePoint que querem encontrar caminhos longos e nomes inválidos na origem antes da primeira cópia, porque renomear depois da migração é mais lento e mais arriscado. Você vai aprender o que a Microsoft documenta, o que ela deixa pouco claro e como corrigir os caminhos mais longos, na ordem certa.

Pontos-chave

  • A Microsoft documenta um limite de 400 caracteres para o caminho decodificado completo do arquivo, incluindo o nome do arquivo, no OneDrive e no SharePoint.
  • O Windows tem limites próprios: os aplicativos de desktop do Office não conseguem abrir arquivos cujo caminho completo ultrapasse 260 caracteres, mesmo quando a nuvem aceita o arquivo.
  • Os caracteres inválidos incluem aspas duplas, asterisco, dois-pontos, sinais de menor e maior que, ponto de interrogação, barras e barra vertical, e não são permitidos espaços no início ou no fim do nome.
  • As fontes divergem sobre a contagem de caminhos codificados versus decodificados e sobre o ponto de partida, então conte a partir de /sites e mantenha uma margem de segurança nas suas verificações.
  • Meça os caminhos na origem, corrija primeiro os mais longos encurtando os nomes das pastas e renomeie os arquivos antes de copiar, e não depois.

Limite de comprimento da URL do SharePoint: o que a Microsoft documenta

A Microsoft informa o limite de 400 caracteres para o SharePoint Online em dois lugares. A descrição do serviço SharePoint limits diz que o caminho decodificado completo do arquivo, incluindo o nome do arquivo, não pode ter mais de 400 caracteres no OneDrive e no SharePoint do Microsoft 365. O artigo de ajuda What are the file path length limits? traz o mesmo número e acrescenta detalhes. Nenhuma das duas páginas descreve uma configuração que aumente o limite, então planeje considerando esse valor.

Pontos principais desse artigo:

  • Cada pasta da hierarquia e o nome do arquivo com sua extensão entram na contagem. Todos os caracteres contam, incluindo separadores, espaços e a extensão.
  • O Office para a web usa os mesmos 400 caracteres.
  • Caracteres especiais, espaços e caracteres acentuados são codificados por URL no SharePoint. Um espaço vira %20.

O ponto da codificação é onde as páginas divergem. O artigo de ajuda diz que as formas codificadas entram na contagem, mas a regra principal se refere ao caminho decodificado. A descrição do serviço menciona apenas o caminho decodificado. A próxima seção mostra o que mais aponta em direções diferentes.

Como o SharePoint conta os caracteres

Três fontes respondem à pergunta sobre a contagem, e elas não coincidem totalmente.

  • Decodificado ou codificado? Uma resposta aceita no Microsoft Q&A, escrita por colaboradores externos da Microsoft, afirma que o comprimento do caminho é calculado sobre o caminho decodificado e aponta para o artigo de restrições. O anúncio de 2017 dizia o mesmo: a Redmondmag cita Bill Baer, da Microsoft, com a frase "There is no limit to encoded URLs in SharePoint Online and OneDrive for Business." A observação do artigo de ajuda de que %20 conta é a exceção.
  • Onde começa a contagem? Outra resposta do Microsoft Q&A, de colaboradores externos da Microsoft, diz que a contagem deve começar no segmento /sites e que os parâmetros de string de consulta devem ser ignorados. Para um link como /sites/SiteName/Shared Documents/Forms/AllItems.aspx?FolderCTID=..., só a parte antes do ponto de interrogação conta. Segundo essa resposta, o nome do site e o nome da biblioteca entram na contagem. O próprio exemplo do artigo de ajuda começa na raiz da biblioteca, então trate a resposta do Q&A como orientação de suporte, não como documentação.
  • E o nome do servidor? A fórmula que a Redmondmag divulgou em 2017 é: protocolo, mais nome do servidor, mais caminho da pasta ou do arquivo, mais nome da pasta ou do arquivo, mais parâmetros. Isso difere da resposta de suporte, e é mais um motivo para não fazer uma contagem no limite.

Disso sai uma regra segura. Conte a partir de /sites, inclua o nome do site, o nome da biblioteca, todas as pastas e o nome do arquivo, e mantenha uma margem de algumas dezenas de caracteres até testar um caso-limite real no seu locatário.

A Microsoft aumentou o limite de caminho?

Uma vez, segundo a Redmondmag. Em maio de 2017, o artigo informou que a Microsoft havia ampliado o comprimento máximo do caminho da URL para SharePoint Online e OneDrive para Empresas, de 256 para 400 unidades de código Unicode. Desde então, o número continua sendo 400 nas páginas da Microsoft citadas acima. Se um guia mais antigo ou uma ferramenta de migração ainda mencionar 256 ou 260, ele descreve o limite antigo ou o limite do Windows, não o limite atual da nuvem.

As colunas de hiperlink têm seu próprio limite de 255 caracteres

Um segundo limite costuma ser confundido com o limite de caminho. Em uma discussão no Microsoft Q&A, uma resposta de suporte da Microsoft diz que a coluna Hyperlink em uma lista ou biblioteca do SharePoint tem limite de 255 caracteres, e que isso é intencional. Uma estrutura de pastas profunda pode facilmente gerar um link mais longo, porque o link para um arquivo repete o nome de cada pasta.

A solução alternativa sugerida é uma coluna Várias linhas de texto com texto rico aprimorado, na qual o link é adicionado com a opção de hiperlink do editor. Os comentaristas da discussão apontam duas desvantagens: o link pode não ser atualizado quando o arquivo de destino é renomeado ou movido, e a opção de texto rico aprimorado não está disponível em bibliotecas de documentos. Nomes de pasta mais curtos evitam o problema pela raiz.

Os limites que causam problemas no Windows

Um caminho pode estar correto no SharePoint e ainda assim quebrar em um computador desktop. O mesmo artigo de ajuda lista o lado do Windows:

  • Os aplicativos desktop do Office não conseguem abrir arquivos cujo caminho completo ultrapasse 260 caracteres, mesmo quando o arquivo está armazenado localmente.
  • O Explorador de Arquivos usa o limite de 260 caracteres para abrir, renomear e mover arquivos. Ele não usa a política de caminhos longos do Windows.
  • A sincronização do OneDrive permite um caminho local total de 520 caracteres: um caminho local de até 400 caracteres mais uma pasta raiz do OneDrive de até 120 caracteres.
  • Nomes individuais de arquivos ou pastas podem ter até 255 caracteres no Explorador de Arquivos e no Finder do macOS.

O caminho local inclui a pasta que contém a biblioteca sincronizada, o que o torna mais longo do que a maioria das pessoas espera. Assim, um caminho de 250 caracteres na nuvem pode chegar a 310 caracteres no notebook de um usuário. Considere 260 como o limite de trabalho para qualquer conteúdo que as pessoas abram a partir de pastas sincronizadas.

Nomes que o SharePoint rejeita

O comprimento é só metade da lista de verificação. O artigo da Microsoft Restrições e limitações no OneDrive e no SharePoint lista o que observar:

  • Caracteres inválidos: aspas duplas, asterisco, dois-pontos, menor que, maior que, ponto de interrogação, barra, barra invertida e barra vertical (pipe).
  • Espaços: não são permitidos espaços no início ou no fim do nome.
  • Nomes reservados: .lock, CON, PRN, AUX, NUL, COM0 a COM9, LPT0 a LPT9, _vti_ e desktop.ini.
  • Prefixos e fragmentos: não é permitido um nome de arquivo que comece com ~$, e _vti_ não pode aparecer em nenhum lugar do nome. O nome forms não é permitido na raiz de uma biblioteca.
  • Sinal de número e sinal de porcentagem: algumas organizações ainda não oferecem suporte a eles em nomes. Administradores globais e administradores do SharePoint podem habilitá-los.

Essas restrições se aplicam a arquivos e pastas. Uma pasta com espaço no fim bloqueia tudo o que está abaixo dela, por isso um único nome de pasta problemático pode causar milhares de itens com falha.

Checklist de pré-migração

Use esta ordem em cada compartilhamento ou site antes de copiar.

  1. Meça o comprimento do caminho na origem. Exporte uma lista com os caminhos completos e calcule o comprimento de cada um. Em um compartilhamento de arquivos, Get-ChildItem -Recurse no PowerShell retorna o nome completo de cada item, e um script curto pode contar os caracteres.
  2. Calcule o caminho de destino. Remova a parte do caminho de origem que não existe na biblioteca e acrescente o novo prefixo relativo à biblioteca. Conte a partir de /sites, pois o nome do site e o nome da biblioteca de documentos fazem parte do total.
  3. Sinalize tudo que passar de 300. O limite de 400 é o limite rígido. Um alerta em 300 deixa espaço para a pasta de sincronização e para renomeações futuras.
  4. Liste caracteres inválidos e nomes reservados. Procure os caracteres acima, espaços no início e no fim e nomes como arquivos ~$.
  5. Corrija pela ordem de impacto. Encurte primeiro o nome da pasta que fica mais alto em uma árvore longa. Um nome de pasta mais curto reduz todos os caminhos abaixo dele.
  6. Meça novamente. Execute a mesma contagem outra vez. Só então planeje a cópia.

As verificações de migração da Microsoft também ajudam. O Migration Manager analisa cada arquivo em busca de possíveis problemas conhecidos, e a SharePoint Migration Tool oferece uma opção que apenas analisa, para que você veja os problemas antes de mover qualquer coisa. Use-as como uma segunda verificação, não como a única.

Exemplo: um caminho longo, dois limites

Este exemplo usa nomes e números fictícios. Um arquivo está em um compartilhamento de arquivos, em um caminho de 247 caracteres abaixo da raiz do compartilhamento, por exemplo 2019/Customer Contracts and Offers/Northwind Rollout Phase 2/Technical Specification and Requirements/Approved Versions/Final Signed Copies/, seguido de um nome de arquivo com 107 caracteres. O destino é uma biblioteca chamada Projects, e o exemplo ignora o nome do site para simplificar os números: a biblioteca acrescenta 9 caracteres de Projects/, e o total fica em 256.

  • Limite da nuvem: 256 está abaixo de 400, então o SharePoint aceita o arquivo.
  • Limite do Windows: um caminho sincronizado típico começa com uma pasta local de 62 caracteres, como C:\Users\anna.example\OneDrive - Contoso\Projects - Team Site\. O total local é 62 + 247 = 309, acima de 260. Os aplicativos de desktop do Office não conseguem abrir o arquivo a partir da pasta de sincronização.

A solução é encurtar os nomes, não aumentar os limites. O líder da migração renomeia as pastas para Contracts, Northwind Phase 2, Tech Spec, Approved e Signed, e o arquivo para Northwind Phase 2 - Tech Spec v3 signed.docx. O caminho abaixo da raiz cai de 247 para 103 caracteres. O total local cai de 309 para 165, bem abaixo de 260 e deixando espaço para um nome de usuário mais longo.

Verifique o lado de negócio antes de renomear. Contratos e especificações técnicas costumam seguir regras de nomenclatura, e os nomes de arquivo podem precisar permanecer idênticos por motivos legais. Nesse caso, encurte as pastas e mantenha os nomes dos arquivos.

Opções quando um caminho é longo demais

Você tem quatro opções, nesta ordem de preferência:

  • Encurte os nomes das pastas. É a forma mais barata de encurtar a URL, e ajuda todos os arquivos abaixo dela.
  • Achate a estrutura. Remova níveis que apenas repetem informações, como Final dentro de Approved. O guia de compartilhamento de arquivos da Microsoft também sugere dividir unidades grandes em bibliotecas menores e mais focadas.
  • Use metadados em vez de pastas. Uma coluna como Ano ou Cliente na biblioteca substitui dois níveis de pasta.
  • Deixe o arquivo para trás. Se ninguém o abre há anos, arquive-o em outro lugar.

Não dependa de um paliativo, como mover o arquivo um nível acima depois da migração. Sem corrigir a causa, a próxima reestruturação também vai falhar.

Combine as regras com os proprietários do conteúdo antes de renomear qualquer coisa. Uma convenção de nomenclatura curta, por exemplo no máximo 40 caracteres por nome de pasta e no máximo 8 níveis de pasta, dá às pessoas uma meta e evita que o novo conteúdo volte a ultrapassar o limite depois da mudança. Repita essa convenção no comunicado da migração, para que as pessoas saibam por que os nomes de pasta que conheciam mudaram.

Erros comuns

  • Contar a partir do ponto errado. O caminho na origem não é o caminho na biblioteca. Calcule o caminho de destino.
  • Esquecer a pasta de sincronização local. Um caminho que funciona no navegador pode falhar nos aplicativos de desktop do Office.
  • Ignorar as regras de contagem. As fontes divergem quanto à codificação e ao ponto de partida, então mantenha uma margem de segurança. Uma solicitação de migração que falha por causa de um único item longo pode esconder a causa real em meio a muitos erros semelhantes.
  • Corrigir nomes depois da cópia. Renomeações na nuvem são sincronizadas com todos os clientes, e renomear depois da movimentação repete um trabalho que você poderia ter feito na origem.
  • Confiar em uma única verificação. Faça sua própria medição e também a análise de migração.

Como o software pode ajudar

PowerShell e uma planilha bastam para começar: liste todos os caminhos com o respectivo comprimento, ordene por comprimento e agrupe por pasta de primeiro nível. As análises de migração da Microsoft oferecem uma segunda visão. Algumas ferramentas de terceiros também oferecem relatórios de caminhos e nomes. Avalie qualquer ferramenta pelo fato de ela contar a partir do ponto de partida correto e mostrar os arquivos e pastas que bloqueiam a cópia.

Próximo passo

Exporte os caminhos de um compartilhamento esta semana e ordene-os por comprimento. Depois, anote quantos arquivos ultrapassam 300 caracteres, porque esse número define o esforço da limpeza para o seu limite de comprimento de URL do SharePoint.

Entities in this article

SharePoint migration SharePoint document libraries SharePoint

Related articles

RSS