Python에서 SSL 모듈 문제로 인한 pip 설치 오류 해결 방법

문제

Python 환경에서 pip을 사용하여 패키지를 설치하려고 할 때 다음과 같은 오류가 발생합니다

WARNING: pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.
WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError("Can't connect to HTTPS URL because the SSL module is not available.")': /simple/yfinance/
...
ERROR: Could not find a version that satisfies the requirement yfinance (from versions: none)
ERROR: No matching distribution found for yfinance

 

이 오류는 Python의 SSL 모듈이 설치되지 않았거나, 올바르게 작동하지 않아 HTTPS 연결이 실패하는 경우 발생합니다.

---

원인

이 문제의 주요 원인은 다음과 같습니다:

1. SSL 모듈 누락: Python이 OpenSSL 라이브러리를 찾지 못해 SSL 모듈을 사용할 수 없는 경우.
2. 라이브러리 의존성 문제: Python 설치 시 필요한 OpenSSL 및 관련 라이브러리들이 제대로 설치되지 않은 경우.
3. 환경 변수 문제: Python 실행 파일의 경로가 제대로 설정되지 않아서 발생할 수 있습니다.

---

해결 방법

이 문제를 해결하기 위해 다음 단계를 따라 수행합니다:

1. 필요한 라이브러리 설치

SSL 모듈을 사용하려면 OpenSSL 라이브러리와 헤더 파일이 필요합니다. 이를 설치합니다.

sudo apt-get update
sudo apt-get install libssl-dev
sudo apt-get install zlib1g-dev

 

2. Python 재설치

Python을 다시 설치하여 SSL 모듈을 포함시켜야 합니다. 소스에서 Python을 다시 컴파일하고 설치합니다.

wget https://www.python.org/ftp/python/3.x.x/Python-3.x.x.tgz  # x.x를 원하는 버전으로 변경
tar xvf Python-3.x.x.tgz
cd Python-3.x.x
./configure --with-ssl
make
sudo make install

3. SSL 모듈 확인

Python이 SSL 모듈을 제대로 인식하는지 확인합니다.

python -c "import ssl; print(ssl.OPENSSL_VERSION)"

 

SSL 버전이 출력되면 SSL 모듈이 제대로 작동하는 것입니다.

4. pip 재설치

이제 pip을 다시 설치해봅니다.

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python get-pip.py

 

5. 패키지 설치

pip이 제대로 작동하면 필요한 패키지들을 설치합니다.

pip install yfinance pandas matplotlib seaborn schedule python-telegram-bot

 

위의 단계를 통해 SSL 모듈 문제를 해결하고 Python 환경에서 pip을 사용하여 패키지를 정상적으로 설치할 수 있습니다.