pip tool로 패키지 설치중 ERROR: metadata-generation-failed. Encountered error while generating package metadata 오류 해결

에러가 난 상황

가상환경 설정하고 pip install -r requirements.txt로 라이브러리 다운로드하던 도중에 해당 오류가 발생했다.

 

 

해결방법

metadata-generation-failed 오류가 뜨는 이유는 여러가지 이유로 발생한다. 주로 4가지 패턴으로 자주 나타는데 이는 다음과 같다. 

 

 

1. 'pip' 및 setuptools에서 오래된 버전 존재 

패키지툴인 pip을 업그레이드 시켜 해결한다. 

 

🖥️ terminal

python.exe pip install --upgrade pip

 

2. 설치하려는 패키지가 사용하는 Python 버전을 지원하지 않는다.

설치하려는 패키지가 Python 버전을 지원하지 않음으로 가상환경을 설정할 때, 적절한 파이썬 버전을 선택하여 가상환경을 설정한다. 가상 환경을 통해서 다른 버전의 파이썬 환경을 구축하려면 구축하려는 파이썬 버전이 설치되어 있어야 한다. 

 

🖥️ terminal

pip install virtualenv # virtualenv 설치
virtualenv venv -p=3.x # python version에 따른 가상환경 설정

source venv/bin/activate      # 맥, 유닉스 가상환경 적용
source venv/scripts/activate  # 윈도우 가상환경 적용

 

3. 패키지 이름이 잘못 입력됨

설치하려는 패키지 이름이 잘못되었는지 확인하고,  패키지 이름을 재 설정하여 설치한다. 

 

4. 누락된 종속 항목이 존재

누락된 종속 항목이 존재하는지 확인하고 재 설치한다. 

 

 

나 같은 경우에는 Django 프레임워크로 프로젝트를 진행하다가 써드 파티 앱을 설치하는 도중에 해당 오류가 났다. 그때 파이썬 버전이 3.11.2 버전을 사용하고 있었는데 파이썬 버전을 3.10으로 낮춘 다음 다시 패키지를 설치하니 해당 오류 없이 성공적으로 패키지를 설치할 수 있었다. 

 

 

---

 참조

https://bobbyhadz.com/blog/python-error-metadata-generation-failed-encountered-error

Error: metadata-generation-failed. Encountered error while generating package metadata | bobbyhadz