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
Removing the MAX_PATH restriction on paths applies only to paths
; https://devblogs.microsoft.com/oldnewthing/20250611-00/?p=111262
// 대상 파일 시스템에 대한 "단일 디렉터리 이름"의 제약은 일반적으로 256이지만 엄밀히는 GetVolumeInformation으로 확인해야 합니다.
// 왜냐하면 유니코드 모드의 Joliet CD-RW의 경우에는 110이고, 기타 네트워크 볼륨인 경우에는 그것의 프로토콜에 의해 정해지기 때문입니다.
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
[이 토픽에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]