Microsoft MVP성태의 닷넷 이야기
.NET : 108. PathTooLongException - 260자 파일 경로 제한 [링크 복사], [링크+제목 복사],
조회: 21503
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 1개 있습니다.)

PathTooLongException - 260자 파일 경로 제한


사실, 저도 지금까지 개발을 해오면서 아래의 예외로 고생한 적은 한번도 없었습니다.

[PathTooLongException]: The specified path, file name, or both are too long. The fully qualified file name must be less than 260 characters, and the directory name must be less than 248 characters.



단지, TFS의 Unit Test나 Team Build에서 발생한 적은 있었는데요. 마이크로소프트가 이를 쉽게 벗어날 수 없는 이유가 아래에 설명되어 있습니다. (Visual C++ 하던 사람들은 흔하게 MAX_PATH 상수로 경로 버퍼를 잡곤하지요.)

Long Paths in .NET, Part 1 of 3 [Kim Hamilton]
; https://learn.microsoft.com/en-us/archive/blogs/bclteam/long-paths-in-net-part-1-of-3-kim-hamilton

Long Paths in .NET, Part 2 of 3: Long Path Workarounds [Kim Hamilton]
; https://learn.microsoft.com/en-us/archive/blogs/bclteam/long-paths-in-net-part-2-of-3-long-path-workarounds-kim-hamilton

Long Paths in .NET, Part 3 of 3 Redux [Kim Hamilton]
; https://learn.microsoft.com/en-us/archive/blogs/bclteam/long-paths-in-net-part-3-of-3-redux-kim-hamilton

덕분에 "\\?\" 접두사를 붙여서 파일 경로를 최대 32k까지 늘리는 방법을 알게 되는군요. ^^ 현재 공식적으로 long-path를 사용하는 방법은 다음의 글에서 잘 설명하고 있습니다.
Maximum Path Length Limitation
; https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation

정리하면, 다음의 레지스트리 키를 명시적으로 설정해야 합니다.

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem]
"LongPathsEnabled"=dword:00000001

유의할 점은, 위의 옵션은 경로의 전체 길이에 대한 제한을 해제하는 것일 뿐, "단일 디렉터리 이름"의 제약은 여전히 256입니다.

CreateDirectory function (winbase.h)
https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-createdirectory#parameters
The 255 character limit per path segment still applies.




참고로, TFS 빌드 시에 260 글자 제한으로 인한 오류 해결을 위해 사용자 정의 "Check-in" 정책이 만들어져 공개된 것도 있습니다.

TFS Max Path mitigation via check-in policy
; https://learn.microsoft.com/en-us/archive/blogs/jampick/tfs-max-path-mitigation-via-check-in-policy



[이 토픽에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 4/14/2025]


비밀번호

댓글 작성자
 




... 46  [47] 
NoWriterDateCnt.TitleFile(s)
18정성태9/19/200411798HTML SELECT 요소에 OPTION 요소를 채우는 C/C++ 예제파일 다운로드1
17정성태11/14/200510529[정보] Visual Studio 6.0 Samples
16정성태9/5/200411699JAVA 로 구현된 NTLM 구현파일 다운로드1
15정성태9/2/200410367Developing Active Server Components with ATL
14정성태7/20/200410667No-Touch Deployment
13정성태6/30/200410754How to read BLOB from Dataset into buffer?
11정성태2/14/200410635XMLHTTP 에서 반환받은 non-XML 데이터를 보여주는 모듈
10정성태2/14/200413609MSIL 디컴파일러 - .NET Reflector [1]
9정성태1/26/200411940스크립트 디코더파일 다운로드1
159정성태12/23/20059613    답변글 [업데이트]: 스크립트 디코더파일 다운로드1
8정성태1/26/200414539게시물 도배 프로그램 방지
7정성태1/26/200413026Microsoft.XMLHTTP 개체로 XML 이 아닌 다른 데이터 가져오기
6정성태8/6/200311804Three Ways to Inject Your Code into Another Process파일 다운로드1
5정성태7/29/200311932SQL 서버 sa 암호를 잊은 경우, 복구하는 방법파일 다운로드1
4정성태7/25/200313447DiskId32 - 물리하드 디스크 정보파일 다운로드2
12정성태6/11/200410417    답변글 [추가] WMI 로 구하는 방법파일 다운로드1
3정성태7/25/200312066C# 프로그래밍 언어에 추후 추가되는 기능파일 다운로드1
2정성태7/25/200312359INFO: COM+ 1.0의 새로운 기능파일 다운로드1
... 46  [47]