WARNING: pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.

※ 업무하면서 습득한 내용들을 정리해 놓은 포스팅입니다 :P 추가로 궁금하신 점은 댓글로 남겨주시고 필요한 자료 있으면 요청주세요! 잘못된 내용이 있으면 고쳐주시면 감사하겠습니다. 자료 퍼가실 때는 출처 남겨주세요!

---

 ο 목차

 

---

※ 코드 보는 방법 참고

ㅇ 달러 기호($)가 있는 경우 -> 리눅스 터미널에서 CLI 명령어 입력

ㅇ "=#" 기호가 있는 경우 -> psql 쉘에서 명령어 입력

ㅇ 꺽쇠가 하나 있는 경우(>) -> 윈도우 명령 프롬프트(cmd)에서 명령어 입력

ㅇ 꺽쇠가 세개 있는 경우(>>>) -> python 쉘에서 명령어 입력

---

안녕하세요, 네모입니다 :)

 

pip로 새로운 패키지를 설치하려는데 제목과 같은 오류가 발생했습니다.

상황에 따라 여러가지 해결 방법이 있겠지만 저와 같은 상황인 분들에게 혹시 도움이 될까 싶어 포스팅하게 되었습니다.

* 참고) OS 환경 = windows 10

 

> 아래 내용 읽기 귀찮고 어려우면 아래 링크의 가장 간단한 방법으로 이동해서 해결

WARNING: pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available. (tistory.com)

 

1. 문제 사례

- 기존에는 pip를 사용해 문제없이 파이썬 패키지를 설치했었으나 어느날 갑자기  "WARNING: pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available." 오류가 발생하더니 pip를 사용하는 모든 명령어가 먹통이 됨.

 

2. 오류 메세지 내용 상세

WARNING: pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.

및 해당 현상으로 인한 기타 다른 오류 메세지 발생

 

3. 문제 원인

1) openssl 패키지 미설치

- TLS/SSL 통신을 위한 패키지가 없는 경우. 하지만 잘 되다가 갑자기(?) 안된다면 패키지가 없을 가능성은 매우 낮음.

 

2) openssl 패키지 저장소 환경변수 설정 X

- openssl 패키지가 있는 저장소에 pip 프로그램이 접근하지 못하는 경우. 이 또한 잘 되다가 갑자기(?) 안된다면 환경변수가 설정되어있지 않을 가능성은 매우 낮음.

 

3) pip 동작의 모호성으로 인한 잘못된 동작

- 높은 확률로 문제가 되는 컴퓨터에는 파이썬의 여러 버전이 설치되어 있거나 아나콘다(anaconda)가 있거나 파이참(pycharm)이 있음.

(즉, pip가 패키지를 설치할 수 있는 여러 인터프리터가 존재, 명확한 명령이 없다면 pip가 어떻게 동작할지 알 수 없고, 의도와 다른 인터프리터에 패키지를 설치하려 할 수 있음.)

 

4. 문제 해결 방법

1) openssl 설치 여부 확인

- 명령 프롬프트에서 파이썬 실행

> python

 

- 파이썬 인터프리터에 아래와 같이 "import ssl" 명령어 입력

>python
Python 3.10.1 (tags/v3.10.1:2cd268a, Dec  6 2021, 19:10:37) [MSC v.1929 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> import ssl
>>>

-> 문제 없이 import 된다면 openssl 패키지 설치가 되어 있음.

 

- 만약 아래와 같이 오류 발생시 해당 패키지 설치가 안 된 것으로 openssl 패키지 설치부터 진행

>>> import ssl
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ModuleNotFoundError: No module named 'ssl'

 

* openssl 설치 참고 사이트 

OpenSSL 윈도우에서 설치하는 방법 (iteastory.com)

OpenSSL 윈도우에서 설치하는 방법

 

2) openssl 저장소를 시스템 환경 변수에 등록

- openssl 패키지가 설치된 파이썬 저장소를 확인해서 시스템 환경 변수에 등록하기

(해당 부분은 컴퓨터 인터프리터 설치 환경별로 다르기 때문에 직접 찾아야 합니다.)

 

3) pip 명령어 명확히 지정해주기

- 아래와 같이 실행하려는 파이썬 인터프리터에 -m 옵션을 줘서 pip 실행하기

> python -m pip install 패키지이름

- 원인이 됐던 pip의 모호성 문제에 대해 실행하려는 인터프리터를 명확히 지정해줌으로써 모호성 오류 해소

※ 파이썬 패키지 저장소인 PYPI 에서도 pip 실행시 모호성 이슈로 인해 "pip install" 보다는 "python -m pip install" 명령어를 사용하라고 가이드에 권고하고 있음.

 

---

만약 저의 경우처럼 잘 되다가 갑자기(?) 안된다면 4.3) 의 방법으로 해결될 확률이 높습니다.

(사실 갑자기는 아니고 본인도 모르는새 뭔가 작업을 했을 가능성이 높음 ;3 쭈글)

 

많은 도움 되시길 바랍니당 :) 아듀

---

※ 좋아요와 구독은 큰 힘이 됩니다. 감사합니다.