M365Con 2027 – 무료 온라인 컨퍼런스 · 11–22 Jan 2027 · 120 sessions→ m365con.net

블로그 · Mirko Peters

SharePoint 경로 길이와 파일 이름 제한: 마이그레이션 전에 해결하세요

By · · Updated

SharePoint URL 길이 제한은 디코딩된 파일 경로 기준 400자입니다. 이 체크리스트로 긴 경로와 잘못된 이름을 찾아 마이그레이션 전에 정리하세요.

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

SharePoint URL 길이 제한은 파일 이름을 포함한 디코딩된 파일 경로 기준 400자입니다. 이보다 긴 경로는 업로드, 복사 또는 동기화에 실패하며, 사용자에게는 파일 대신 오류가 표시됩니다. 이 체크리스트는 SharePoint 마이그레이션 담당자가 첫 복사 전에 원본에서 긴 경로와 잘못된 이름을 찾도록 돕기 위한 것입니다. 마이그레이션 후 이름을 바꾸는 것은 더 느리고 위험하기 때문입니다. Microsoft가 문서화한 내용, 명확하지 않은 부분, 그리고 가장 긴 경로를 순서대로 줄이는 방법을 확인할 수 있습니다.

핵심 포인트

  • Microsoft는 OneDrive와 SharePoint에서 파일 이름을 포함한 디코딩된 전체 파일 경로의 제한을 400자로 문서화하고 있습니다.
  • Windows에는 별도의 제한이 있습니다. 클라우드에서 파일을 허용하더라도 전체 경로가 260자를 넘는 파일은 Office 데스크톱 앱에서 열 수 없습니다.
  • 잘못된 문자에는 큰따옴표, 별표, 콜론, 꺾쇠괄호, 물음표, 슬래시, 파이프가 포함되며, 이름 앞뒤의 공백도 허용되지 않습니다.
  • 인코딩 기준과 계산 시작점에 대해서는 출처마다 의견이 다르므로, /sites부터 계산하고 점검 시 안전 여유를 두세요.
  • 원본에서 경로를 측정하고, 가장 긴 경로부터 폴더 이름을 줄여 정리하세요. 파일 이름은 복사한 뒤가 아니라 복사하기 전에 변경하세요.

SharePoint URL 길이 제한: Microsoft 문서 내용

Microsoft는 SharePoint Online의 400자 제한을 두 곳에서 밝히고 있습니다. 서비스 설명 SharePoint limits에는 Microsoft 365의 OneDrive와 SharePoint에서 파일 이름을 포함한 디코딩된 전체 파일 경로가 400자를 넘을 수 없다고 적혀 있습니다. 도움말 문서 What are the file path length limits?도 같은 수치를 제시하며 세부 내용을 덧붙입니다. 두 문서 모두 이 제한을 높일 수 있는 설정을 설명하지 않으므로, 이 수치를 전제로 계획을 세우세요.

해당 문서의 핵심 내용은 다음과 같습니다.

  • 계층 구조의 모든 폴더와 확장자를 포함한 파일 이름이 길이에 포함됩니다. 구분 기호, 공백, 확장자를 포함해 모든 문자가 계산됩니다.
  • Office for the web도 동일하게 400자를 적용합니다.
  • SharePoint에서는 특수 문자, 공백, 악센트가 있는 문자가 URL 인코딩됩니다. 공백은 %20으로 바뀝니다.

인코딩 기준은 문서마다 설명이 다른 부분입니다. 도움말 문서는 인코딩된 형태가 제한에 포함된다고 하면서도, 주요 규칙에서는 디코딩된 경로를 기준으로 합니다. 서비스 설명은 디코딩된 경로만 언급합니다. 다음 섹션에서는 이 밖에 어떤 부분이 서로 다르게 설명되는지 살펴봅니다.

SharePoint가 문자를 세는 방식

문자 계산 방식에 대해서는 세 가지 출처가 답을 제시하지만, 그 내용이 완전히 일치하지는 않습니다.

  • 디코딩된 경로인가, 인코딩된 경로인가? Microsoft 외부 직원이 작성하고 Microsoft Q&A에서 채택된 답변은, 경로 길이가 디코딩된 경로를 기준으로 계산된다고 하면서 제한 사항 문서를 가리킵니다. 2017년 발표도 같은 내용이었습니다. Redmondmag는 Microsoft의 Bill Baer의 말을 인용하며 "There is no limit to encoded URLs in SharePoint Online and OneDrive for Business."라고 전했습니다. 도움말 문서에서 %20이 길이에 포함된다고 한 부분이 예외에 해당합니다.
  • 계산은 어디서부터 시작하나요? Microsoft 외부 직원이 작성한 다른 Microsoft Q&A 답변은 /sites 세그먼트에서 시작하고 쿼리 문자열 매개 변수는 무시하라고 합니다. 예를 들어 /sites/SiteName/Shared Documents/Forms/AllItems.aspx?FolderCTID=...와 같은 링크라면 물음표 앞부분만 계산에 포함됩니다. 이 답변에 따르면 사이트 이름과 라이브러리 이름도 포함됩니다. 다만 도움말 문서의 예시는 라이브러리 루트에서 시작하므로, 이 Q&A 답변은 공식 문서가 아니라 지원 차원의 안내로 보는 것이 좋습니다.
  • 서버 이름은 어떻게 되나요? Redmondmag가 2017년에 보도한 공식은 다음과 같습니다. 프로토콜 + 서버 이름 + 폴더 또는 파일 경로 + 폴더 또는 파일 이름 + 매개 변수. 이는 지원 답변과 다르며, 이것이 바로 여유를 두지 않고 빠듯하게 계산하면 안 되는 또 하나의 이유입니다.

이로부터 안전한 규칙을 도출할 수 있습니다. /sites부터 계산하고, 사이트 이름, 라이브러리 이름, 모든 폴더와 파일 이름을 포함하되, 테넌트에서 실제 경계 사례를 테스트하기 전까지는 수십 자 정도의 여유를 두십시오.

Microsoft가 경로 제한을 늘렸나요?

Redmondmag에 따르면 한 번 늘렸습니다. 이 기사는 2017년 5월 Microsoft가 SharePoint Online과 OneDrive for Business의 최대 URL 경로 길이를 256에서 400 유니코드 코드 단위로 늘렸다고 보도했습니다. 그 이후 위에서 인용한 Microsoft 페이지에는 계속 400으로 나와 있습니다. 오래된 가이드나 마이그레이션 도구가 여전히 256 또는 260이라고 말한다면, 이는 현재 클라우드 제한이 아니라 예전 제한이나 Windows 제한을 설명하는 것입니다.

하이퍼링크 열에는 별도의 255자 제한이 있습니다

경로 제한과 자주 혼동되는 두 번째 제한이 있습니다. Microsoft Q&A 스레드에서 Microsoft 지원 답변은 SharePoint 목록이나 라이브러리의 하이퍼링크 열에 255자 제한이 있으며 이는 설계상의 특성이라고 설명합니다. 폴더 구조가 깊으면 파일 링크가 모든 폴더 이름을 반복하므로 링크가 그보다 길어지기 쉽습니다.

제안된 해결 방법은 향상된 리치 텍스트를 사용하는 여러 줄 텍스트 열에서 편집기의 하이퍼링크 옵션으로 링크를 추가하는 것입니다. 스레드의 댓글 작성자들은 두 가지 단점을 지적합니다. 대상 파일의 이름이 바뀌거나 이동되면 링크가 업데이트되지 않을 수 있고, 향상된 리치 텍스트 옵션은 문서 라이브러리에서 사용할 수 없습니다. 근본적으로 문제를 피하려면 폴더 이름을 더 짧게 짓는 것이 가장 좋습니다.

Windows에서 문제가 되는 제한

경로가 SharePoint에서는 문제없어도 데스크톱에서는 깨질 수 있습니다. 같은 도움말 문서는 Windows 측 제한도 나열합니다.

  • Office 데스크톱 앱은 로컬에 저장된 파일이라도 전체 경로가 260자를 초과하면 열 수 없습니다.
  • 파일 탐색기는 파일을 열고, 이름을 바꾸고, 이동할 때 260자 제한을 사용합니다. Windows의 긴 경로 정책은 사용하지 않습니다.
  • OneDrive 동기화는 로컬 경로 전체를 520자까지 허용합니다. 이는 최대 400자의 로컬 경로와 최대 120자의 OneDrive 루트 폴더를 합친 길이입니다.
  • 개별 파일이나 폴더 이름은 파일 탐색기와 macOS Finder에서 최대 255자까지 가능합니다.

로컬 경로에는 동기화된 라이브러리를 담고 있는 폴더도 포함되는데, 이는 대부분의 사람이 예상하는 것보다 깁니다. 따라서 클라우드에서 250자인 경로가 사용자의 노트북에서는 310자가 될 수 있습니다. 사람들이 동기화된 폴더에서 여는 모든 콘텐츠는 260자를 실질적인 작업 한도로 생각하십시오.

SharePoint가 거부하는 이름

길이는 점검 목록의 절반일 뿐입니다. Microsoft 문서 OneDrive 및 SharePoint의 제한 사항에는 확인해야 할 항목이 나열되어 있습니다.

  • 사용할 수 없는 문자: 큰따옴표, 별표, 콜론, 작은 기호(<), 큰 기호(>), 물음표, 슬래시, 백슬래시, 파이프입니다.
  • 공백: 이름의 앞이나 뒤에 공백을 사용할 수 없습니다.
  • 예약된 이름: .lock, CON, PRN, AUX, NUL, COM0~COM9, LPT0~LPT9, _vti_, desktop.ini입니다.
  • 접두사와 조각: ~$로 시작하는 파일 이름은 사용할 수 없습니다. 또한 _vti_는 이름 어디에도 들어갈 수 없습니다. 라이브러리 루트에서는 forms 이름을 사용할 수 없습니다.
  • 번호 기호와 백분율 기호: 일부 조직에서는 아직 이름에 이 기호를 지원하지 않습니다. 전역 관리자와 SharePoint 관리자가 이를 사용하도록 설정할 수 있습니다.

이 제한은 파일과 폴더 모두에 적용됩니다. 끝에 공백이 있는 폴더는 그 아래의 모든 항목을 막으므로, 폴더 이름 하나만 잘못되어도 수천 개의 항목이 실패할 수 있습니다.

마이그레이션 전 점검 목록

복사하기 전에 모든 공유 폴더나 사이트에서 다음 순서를 따르십시오.

  1. 원본에서 경로 길이를 측정합니다. 모든 전체 경로의 목록을 내보내고 각 경로의 길이를 계산합니다. 파일 공유의 경우 PowerShell의 Get-ChildItem -Recurse는 모든 항목의 전체 이름을 반환하며, 간단한 스크립트로 문자 수를 셀 수 있습니다.
  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라는 라이브러리이며, 계산을 단순하게 하기 위해 사이트 이름은 제외합니다. 라이브러리가 Projects/로 9자를 더하므로 전체 길이는 256자입니다.

  • 클라우드 한도: 256은 400보다 작으므로 SharePoint는 이 파일을 허용합니다.
  • Windows 한도: 일반적인 동기화 경로는 C:\Users\anna.example\OneDrive - Contoso\Projects - Team Site\와 같이 62자의 로컬 폴더로 시작합니다. 로컬 전체 길이는 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을 줄이는 가장 저렴한 방법이며, 아래에 있는 모든 파일에 도움이 됩니다.
  • 구조를 단순화합니다. Approved 안의 Final처럼 정보만 반복하는 단계를 제거합니다. Microsoft의 파일 공유 가이드는 대용량 드라이브를 더 작고 목적이 뚜렷한 라이브러리로 나누는 것도 제안합니다.
  • 폴더 대신 메타데이터를 사용하십시오. 라이브러리의 Year나 Customer 같은 열이 폴더 두 단계를 대신합니다.
  • 오래된 파일은 남겨 두지 마십시오. 몇 년 동안 아무도 열어 보지 않은 파일이라면 다른 곳에 보관하십시오.

마이그레이션 후 파일을 상위 폴더로 옮기는 것과 같은 임시방편에 의존하지 마십시오. 원인을 해결하지 않으면 다음 구조 개편에서도 같은 문제가 발생합니다.

이름을 바꾸기 전에 콘텐츠 소유자와 규칙을 합의하십시오. 예를 들어 폴더 이름은 40자 이내, 폴더 수준은 8단계 이내로 하는 간단한 명명 규칙을 정하면 목표가 생기고, 이동 후에도 새 콘텐츠가 제한을 다시 넘지 않도록 할 수 있습니다. 마이그레이션 공지에도 같은 내용을 반복하여, 사람들이 익숙한 폴더 이름이 왜 바뀌었는지 이해하도록 하십시오.

흔한 실수

  • 잘못된 기준점에서 계산하지 마십시오. 원본의 경로는 라이브러리의 경로와 다릅니다. 대상 경로를 기준으로 계산하십시오.
  • 로컬 동기화 폴더를 잊지 마십시오. 브라우저에서는 동작하는 경로도 Office 데스크톱 앱에서는 실패할 수 있습니다.
  • 계산 규칙을 무시하지 마십시오. 자료마다 인코딩과 시작 기준점이 다르므로 여유를 두십시오. 긴 항목 하나 때문에 마이그레이션 요청이 실패하면, 비슷한 오류가 많은 가운데 실제 원인이 가려질 수 있습니다.
  • 복사 후에 이름을 고치지 마십시오. 클라우드에서 이름을 바꾸면 모든 클라이언트에 동기화되며, 이동 후 이름을 바꾸는 작업은 원본에서 미리 할 수 있었던 작업을 반복하는 것입니다.
  • 단일 검사만 믿지 마십시오. 직접 측정하고 마이그레이션 검사도 함께 실행하십시오.

소프트웨어가 도움이 되는 방식

시작하는 데는 PowerShell과 스프레드시트면 충분합니다. 모든 경로와 길이를 나열하고, 길이순으로 정렬한 뒤 최상위 폴더별로 묶으십시오. Microsoft의 마이그레이션 검사는 두 번째 관점을 제공합니다. 일부 타사 도구도 경로 및 이름 보고서를 제공합니다. 도구를 평가할 때는 올바른 기준점에서 계산하는지, 그리고 복사를 막는 파일과 폴더를 보여 주는지를 기준으로 판단하십시오.

다음 단계

이번 주에 한 공유 폴더의 경로를 내보내고 길이순으로 정렬하십시오. 그다음 300자를 초과하는 파일이 몇 개인지 기록하십시오. 이 수치가 SharePoint URL 길이 제한 정리 작업의 工数을 결정하기 때문입니다.

Entities in this article

SharePoint migration SharePoint document libraries SharePoint

Related articles

RSS