M365Con 2027 – бесплатная онлайн-конференция · 11–22 Jan 2027 · 120 sessions→ m365con.net

Блог · Mirko Peters

Ограничения на длину пути и имена файлов в SharePoint: исправьте их до миграции

By · · Updated

Ограничение длины URL в SharePoint составляет 400 символов для декодированного пути к файлу. Найдите длинные пути и недопустимые имена с помощью этого чек-листа до миграции.

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

Ограничение длины URL в SharePoint составляет 400 символов для декодированного пути к файлу, включая имя файла. Файлы с более длинным путём не загружаются, не копируются и не синхронизируются: вместо файла пользователи видят ошибку. Этот чек-лист предназначен для руководителей миграции в SharePoint, которые хотят найти длинные пути и недопустимые имена в исходной системе до первого копирования, потому что переименование после миграции занимает больше времени и сопряжено с большими рисками. Вы узнаете, что документирует Microsoft, что остаётся неясным, и как по порядку исправлять самые длинные пути.

Ключевые выводы

  • Microsoft документирует ограничение в 400 символов для всего декодированного пути к файлу, включая имя файла, в OneDrive и SharePoint.
  • Windows добавляет собственные ограничения: классические приложения Office не могут открыть файлы, полный путь к которым превышает 260 символов, даже если облако принимает такой файл.
  • К недопустимым символам относятся двойная кавычка, звёздочка, двоеточие, угловые скобки, вопросительный знак, косые черты и вертикальная черта. Пробелы в начале и в конце имени также не допускаются.
  • Источники расходятся в вопросах подсчёта закодированных и декодированных символов и точки отсчёта, поэтому ведите подсчёт от /sites и оставляйте запас безопасности в проверках.
  • Измеряйте пути в исходной системе, сначала исправляйте самые длинные, сокращая имена папок, и переименовывайте файлы до копирования, а не после.

Ограничение длины URL в SharePoint: что документирует Microsoft

Microsoft указывает ограничение в 400 символов для SharePoint Online в двух местах. В описании службы «SharePoint limits» сказано, что весь декодированный путь к файлу, включая имя файла, не может содержать более 400 символов для OneDrive и SharePoint в Microsoft 365. Статья «What are the file path length limits?» приводит то же число и дополнительные подробности. Ни на одной из страниц не описано средство повышения лимита, поэтому планируйте работу с учётом этого ограничения.

Ключевые моменты из этой статьи:

  • Учитываются все папки в иерархии и имя файла с расширением. Считается каждый символ, включая разделители, пробелы и расширение.
  • Office для Интернета использует то же ограничение в 400 символов.
  • Специальные символы, пробелы и символы с диакритическими знаками в SharePoint кодируются в URL. Пробел превращается в %20.

В вопросе кодирования страницы расходятся. В справочной статье сказано, что закодированные формы учитываются в лимите, однако её основное правило относится к декодированному пути. В описании службы упоминается только декодированный путь. В следующем разделе показано, что ещё указывает в разных направлениях.

Как SharePoint считает символы

Три источника отвечают на вопрос о подсчёте, но полностью не совпадают.

  • Декодированный или закодированный путь? Принятый ответ в Microsoft Q&A, написанный внешним сотрудником Microsoft, утверждает, что длина пути рассчитывается по декодированному пути, и ссылается на статью об ограничениях. Объявление 2017 года говорило то же самое: Redmondmag цитирует Билла Баера из Microsoft: «Для закодированных URL в SharePoint Online и OneDrive для бизнеса ограничения нет». Примечание справочной статьи о том, что %20 учитывается, — исключение.
  • С чего начинается отсчёт? Ещё один ответ в Microsoft Q&A от внешнего сотрудника Microsoft советует начинать отсчёт с сегмента /sites и не учитывать параметры строки запроса. Для ссылки вида /sites/SiteName/Shared Documents/Forms/AllItems.aspx?FolderCTID=... учитывается только часть до знака вопроса. По этому ответу учитываются имя сайта и имя библиотеки. Собственный пример справочной статьи начинается с корня библиотеки, поэтому ответ в Q&A стоит воспринимать как рекомендацию поддержки, а не как документацию.
  • А что с именем сервера? Формула, которую Redmondmag приводил в 2017 году: протокол, плюс имя сервера, плюс путь к папке или файлу, плюс имя папки или файла, плюс параметры. Она отличается от ответа поддержки, и это ещё одна причина не рассчитывать на точный подсчёт.

Из этого следует простое правило. Ведите отсчёт от /sites, учитывайте имя сайта, имя библиотеки, каждую папку и имя файла и оставляйте запас в несколько десятков символов, пока не проверите реальный пограничный случай в своём клиенте.

Microsoft увеличила ограничение на длину пути?

Один раз, по данным Redmondmag. В мае 2017 года статья сообщала, что Microsoft увеличила максимальную длину пути URL для SharePoint Online и OneDrive для бизнеса с 256 до 400 единиц кода Unicode. С тех пор на страницах Microsoft, которые цитируются выше, это число остаётся 400. Если более старое руководство или инструмент миграции всё ещё называет 256 или 260, он описывает старое ограничение или ограничение Windows, а не текущее ограничение облака.

У столбцов «Гиперссылка» собственное ограничение в 255 символов

Второе ограничение часто путают с ограничением длины пути. В ветке Microsoft Q&A ответ службы поддержки Microsoft говорит, что у столбца «Гиперссылка» в списке или библиотеке SharePoint ограничение 255 символов и что это задумано так намеренно. Глубокая структура папок легко создаёт ссылку, которая длиннее, потому что ссылка на файл повторяет имя каждой папки.

Предлагаемый обходной путь — столбец «Многострочный текст» с расширенным форматированием, куда ссылка добавляется через параметр гиперссылки редактора. Участники обсуждения называют два недостатка: ссылка может не обновиться, если целевой файл переименован или перемещён, а параметр расширенного форматирования текста недоступен в библиотеках документов. Более короткие имена папок решают проблему в корне.

Ограничения, которые проявляются в Windows

Путь может работать в SharePoint, но сломаться на настольном компьютере. В той же справочной статье перечислены ограничения со стороны Windows:

  • Настольные приложения Office не могут открыть файлы, полный путь к которым превышает 260 символов, даже если файл хранится локально.
  • Проводник использует ограничение в 260 символов при открытии, переименовании и перемещении файлов. Он не использует политику длинных путей Windows.
  • Синхронизация OneDrive допускает общий локальный путь в 520 символов: локальный путь до 400 символов плюс корневая папка OneDrive до 120 символов.
  • Имена отдельных файлов или папок могут содержать до 255 символов в Проводнике и в Finder на macOS.

Локальный путь включает папку, в которой хранится синхронизированная библиотека, и он длиннее, чем большинство людей ожидает. Поэтому путь длиной 250 символов в облаке может стать 310 символами на ноутбуке пользователя. Считайте 260 рабочим ограничением для любого содержимого, которое пользователи открывают из синхронизированных папок.

Имена, которые отклоняет SharePoint

Длина — лишь половина контрольного списка. В статье Microsoft Ограничения и лимиты в OneDrive и SharePoint перечислено, на что нужно обращать внимание:

  • Недопустимые символы: двойная кавычка, звёздочка, двоеточие, знак «меньше», знак «больше», вопросительный знак, косая черта, обратная косая черта и вертикальная черта.
  • Пробелы: пробелы в начале и в конце имени не допускаются.
  • Зарезервированные имена: .lock, CON, PRN, AUX, NUL, от COM0 до COM9, от LPT0 до LPT9, _vti_ и desktop.ini.
  • Префикс и фрагменты: имя файла, которое начинается с ~$, не допускается, а _vti_ не может встречаться нигде в имени. Имя forms не допускается в корне библиотеки.
  • Знаки «#» и «%»: некоторые организации пока не поддерживают их в именах. Глобальные администраторы и администраторы SharePoint могут их включить.

Эти ограничения действуют и для файлов, и для папок. Папка с пробелом в конце блокирует всё, что находится ниже неё, поэтому одно некорректное имя папки может привести к тысячам неудачных элементов.

Контрольный список перед миграцией

Используйте этот порядок для каждого общего ресурса или сайта перед копированием.

  1. Измерьте длину пути в источнике. Экспортируйте список полных путей и вычислите длину каждого. Для файлового ресурса Get-ChildItem -Recurse в PowerShell возвращает полное имя каждого элемента, а короткий скрипт может подсчитать количество символов.
  2. Рассчитайте целевой путь. Удалите часть исходного пути, которой нет в библиотеке, и добавьте новый префикс относительно библиотеки. Считайте от /sites, так как имя сайта и имя библиотеки документов входят в общую длину.
  3. Отметьте всё, что длиннее 300. Предел в 400 символов является жёстким. Отметка 300 оставляет запас для папки синхронизации и будущих переименований.
  4. Составьте список недопустимых символов и зарезервированных имён. Ищите перечисленные выше символы, пробелы в начале и в конце имён, а также имена вроде файлов ~$.
  5. Исправляйте по степени влияния. Сначала сократите имя папки, которая находится выше всего в длинном дереве. Одно более короткое имя папки укорачивает все пути ниже неё.
  6. Измерьте повторно. Выполните тот же подсчёт ещё раз. Только после этого планируйте копирование.

Помогают и средства проверки миграции от Microsoft. Migration Manager сканирует каждый файл на известные потенциальные проблемы, а SharePoint Migration Tool предлагает режим только сканирования, чтобы вы увидели проблемы до переноса. Используйте их как вторую проверку, а не как единственную.

Пример: один длинный путь, два ограничения

В этом примере имена и числа вымышленные. Файл находится на файловом ресурсе по пути длиной 247 символов от корня ресурса, например 2019/Customer Contracts and Offers/Northwind Rollout Phase 2/Technical Specification and Requirements/Approved Versions/Final Signed Copies/, а за ним следует имя файла длиной 107 символов. Целевая библиотека называется Projects, а имя сайта в примере не учитывается, чтобы упростить расчёты: библиотека добавляет 9 символов для Projects/, и общая длина составляет 256.

  • Облачное ограничение: 256 меньше 400, поэтому SharePoint примет файл.
  • Ограничение Windows: типичный путь синхронизации начинается с локальной папки длиной 62 символа, например C:\Users\anna.example\OneDrive - Contoso\Projects - Team Site\. Локальная общая длина составляет 62 + 247 = 309, что больше 260. Настольные приложения Office не могут открыть файл из папки синхронизации.

Решение состоит в том, чтобы сокращать имена, а не повышать ограничения. Руководитель миграции переименовывает папки в Contracts, Northwind Phase 2, Tech Spec, Approved и Signed, а файл в Northwind Phase 2 - Tech Spec v3 signed.docx. Путь от корня сокращается с 247 до 103 символов. Локальная общая длина падает с 309 до 165, что заметно меньше 260 и оставляет место для более длинного имени пользователя.

Перед переименованием проверьте бизнес-сторону. Договоры и технические спецификации часто подчиняются правилам именования, а имена файлов по юридическим причинам могут требовать сохранения. В этом случае сокращайте папки и сохраняйте имена файлов.

Варианты, если путь слишком длинный

У вас есть четыре варианта, в порядке предпочтения:

  • Сократите имена папок. Это самый дешёвый способ укоротить URL, и это помогает всем файлам внутри.
  • Упростите структуру. Удалите уровни, которые только повторяют информацию, например Final внутри Approved. Руководство Microsoft по файловым ресурсам также советует разбивать большие диски на более мелкие и тематически направленные библиотеки.
  • Используйте метаданные вместо папок. Столбец, например «Год» или «Клиент», в библиотеке заменяет два уровня вложенности папок.
  • Оставьте устаревшие файлы в прошлом. Если к файлу никто не обращался годами, перенесите его в архив.

Не полагайтесь на обходной путь, например на перемещение файла на уровень выше после миграции. Пока причина не устранена, следующая реорганизация тоже завершится ошибкой.

Согласуйте правила с владельцами контента до того, как что-либо переименовывать. Короткое соглашение об именовании, например не более 40 символов в имени папки и не более 8 уровней вложенности, даёт людям ориентир и не позволяет новому контенту снова выйти за пределы ограничений после переноса. Повторите его в анонсе миграции, чтобы люди понимали, почему привычные названия папок изменились.

Распространённые ошибки

  • Отсчёт от неверной точки. Путь в источнике — это не путь в библиотеке. Рассчитайте целевой путь.
  • Забытая локальная папка синхронизации. Путь, который работает в браузере, может не работать в классических приложениях Office.
  • Игнорирование правил подсчёта. Источники расходятся в вопросах кодировки и точки отсчёта, поэтому оставляйте запас. Запрос на миграцию, который завершается ошибкой из-за одного длинного элемента, может скрыть настоящую причину среди множества похожих ошибок.
  • Исправление имён после копирования. Переименования в облаке синхронизируются на все клиенты, а переименование после переноса повторяет работу, которую можно было выполнить в исходной системе.
  • Доверие одной проверке. Проведите собственные измерения и выполните сканирование миграции.

Как может помочь программное обеспечение

Для старта достаточно PowerShell и электронной таблицы: выведите все пути с их длиной, отсортируйте по длине и сгруппируйте по папкам верхнего уровня. Сканирования миграции от Microsoft дают второй взгляд на данные. Некоторые сторонние инструменты также формируют отчёты по путям и именам. Оценивайте любой инструмент по тому, ведётся ли отсчёт от правильной точки и показывает ли он файлы и папки, которые блокируют копирование.

Следующий шаг

На этой неделе выгрузите пути одного общего ресурса и отсортируйте их по длине. Затем запишите, сколько файлов превышают 300 символов, поскольку именно это число определит объём работ по очистке от ограничения длины URL в SharePoint.

Entities in this article

SharePoint migration SharePoint document libraries SharePoint

Related articles

RSS