[Python] 패키지 설치 SSL Error 해결

이번 글에서는 Python 환경에서 패키지 설치 중 발생한 SSL 인증서 오류를 해결하는 과정을 정리하고자 합니다. sentence-transformers 라이브러리를 설치하는 과정에서 발생한 문제와 해결법을 중심으로 설명하겠습니다.

---

문제 상황

처음 pip install 명령어로 sentence-transformers를 설치하려 했을 때 다음과 같은 오류가 발생했습니다.

WARNING: Retrying (Retry(total=3, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLCertVerificationError...
ERROR: Could not find a version that satisfies the requirement sentence-transformers
Could not fetch URL https://pypi.org/simple/sentence-transformers/: There was a problem confirming the ssl certificate: HTTPSConnectionPool...

주요 오류 메시지:

• SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED]
• SSL 인증서 확인에 실패하여 PyPI 서버에 연결할 수 없다는 내용입니다.

---

원인 분석

이 오류는 다음과 같은 이유로 발생할 수 있습니다.

1. 시스템의 인증서가 최신이 아니거나 누락된 경우
2. 네트워크 환경에서 SSL 인증서를 제대로 검증하지 못하는 경우 (방화벽, 프록시 서버 등의 영향)

---

해결 방법

오류를 해결하기 위해 다음 방법을 시도했습니다.

1. --trusted-host 옵션 사용
   

   pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org sentence-transformers

    --trusted-host 옵션을 통해 SSL 인증서를 강제로 무시하도록 설정했습니다. 이 옵션을 추가하면 PyPI 서버와 파일 호스팅 서버에 대한 인증서 검증을 생략하게 됩니다.
2. 결과 위 명령어 실행 후 정상적으로 패키지가 설치되었습니다.

---

완성된 명령어

최종적으로 사용한 명령어는 다음과 같습니다.

pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org sentence-transformers

이 명령어로 SSL 인증서 문제를 우회하여 패키지를 설치할 수 있었습니다.

---

주의 사항

• --trusted-host 옵션은 SSL 인증서 검증을 생략하기 때문에 보안상 위험이 있을 수 있습니다. 따라서 이 방법은 임시 해결책으로 사용하는 것이 좋습니다.
• 인증서가 오래되었거나 누락된 경우 시스템의 루트 인증서를 최신 버전으로 업데이트하는 것이 보다 안전한 해결책입니다.