👨🏻‍💻 Server

urllib3 v2.0 Only Supports OpenSSL 1.1.1+ 에러 해결

🚀SOO 2025. 1. 12. 23:24

1. 소개

confluent-kafka-python를 통해서 pub/sub 구현하는 과정에서 생긴 에러입니다. 연습으로 위 코드를 만져보고 있다가 마주치게 된 에러를 공유드립니다.

2. 환경 정보

  • Mac os : ventura 13.5(22G74) _ mac air m1
  • Python : 3.9.6

3. 에러 내용

lib/python3.9/site-packages/urllib3/__init__.py:34: NotOpenSSLWarning: urllib3 v2.0 only supports OpenSSL 1.1.1+, currently the 'ssl' module is compiled with 'LibreSSL 2.8.3'.

NotOpenSSLWarning 메세지는 python ssl 모듈이 libreSSL 2.8.3로 컴파일 되어 있으나 urllib3 v2.0은 openSSL 1.1.1+ 만 지원한다는 의미입니다.

4. 문제 분석

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

의존성 관련 문제라는 것을 확인했습니다. mac 최근에 사용, 업데이트하신 분들은 유사한 문제를 겪을 수 있습니다.

5. 해결 방안

가능한 해결 방법

  1. python 버전 downgrade
  2. python recompile
  3. LibreSSL → OpenSSL 1.1.1+ 교체
  4. urllib3 버전 downgrade로 호환성 맞추기

해결 과정

# 실행 명령어
1. source ${project_path}/venv_path/bin/activate 
2. (venv_examples)  ..(project path, user name).. pip uninstall urllib3 
3. pip install 'urllib3<2.0'
4. pip list | grep -i urllib3

# 실행 결과
urllib3                   1.26.16

⚠️ 주의사항: 유지보수 중 변경은 꼭 주의바랍니다. 위 모듈은 다른 lib와 연관성이 높을 수 있습니다.