vcpkg로 onnxruntime-gpu 설치 시 Invalid empty pathname 에러

최근에 Windows 환경에서 onnxruntime-gpu를 vcpkg로 설치하다가 꽤 황당한 문제를 겪었습니다. 동일한 문제를 만나는 분들이 있을 것 같아 기록을 남겨둡니다.

---

문제 상황

다음 명령어로 onnxruntime-gpu를 설치했습니다.

vcpkg install onnxruntime-gpu:x64-windows

처음에는 정상적으로 다운로드가 진행되다가, microsoft-onnxruntime-v1.19.2.tar.gz 압축을 해제하는 단계에서 에러가 발생했습니다.

CMake Error: Problem with archive_write_header(): Invalid empty pathname
CMake Error: Current file: 
CMake Error: Problem extracting tar: C:/vcpkg/downloads/microsoft-onnxruntime-v1.19.2.tar.gz

처음엔 파일이 손상된 줄 알고 downloads 폴더의 파일을 지우고 다시 받아보기도 하고, 수동으로 tar.gz를 풀어서 넣어보기도 했습니다. 하지만 계속 같은 에러가 발생했습니다.

---

원인 추적

검색해 보니 CMake의 libarchive가 압축을 풀 때 로캘/언어 설정 문제로 경로를 제대로 읽지 못하면, 내부적으로 "empty pathname"을 만들어 버리면서 압축 해제에 실패할 수 있다고 하더군요.

즉, 제 환경에서 Windows 시스템 언어가 한국어로 설정되어 있어서 문제가 발생한 것이었습니다.

---

해결 방법

시스템 언어를 영어(United States)로 변경 후 다시 시도했더니, 아무 문제 없이 설치가 진행되었습니다.

정리하자면:

1. vcpkg install onnxruntime-gpu:x64-windows 실행 시 Invalid empty pathname 에러가 난다면,
2. 시스템 언어/로캘을 영어로 변경하거나,
3. vcpkg 디렉토리를 C:\dev\vcpkg 같이 완전히 영어 경로에 두고 시도하면 해결됩니다.

---

교훈

• Windows 개발 환경에서 C/C++ 라이브러리 빌드 시, 로캘 문제로 의외의 오류가 발생할 수 있다.
• 특히 vcpkg, CMake는 아직 한글 경로나 로캘에 취약하다.
• 개발 환경은 가능하면 영어 경로/영어 로캘을 유지하는 것이 정신 건강에 좋다 🙂

---

혹시 저와 같은 문제를 겪으신 분들이 있다면, 위 방법을 시도해 보시길 바랍니다!