[Python] RuntimeError: module compiled against API version 0xf but this version of numpy is 0xe 에러 해결

파이썬 개발을 하다 보면 라이브러리 간의 버전 충돌이나 호환성 문제로 예상치 못한 오류를 만날 때가 있습니다. 최근 저도 requirements.txt에 있는 라이브러리를 설치하고 코드를 실행했을 때, 아래와 같은 RuntimeError를 겪었습니다.

발생했던 문제: RuntimeError: module compiled against API version 0xf but this version of numpy is 0xe

pip install numpy를 성공적으로 마친 후 main.py 파일을 실행하자마자 위와 같은 오류 메시지가 떴습니다.

이 메시지는 '특정 모듈이 컴파일된 파이썬 API 버전(0xf)과 현재 설치된 NumPy 버전(0xe)의 API가 서로 다르다' 는 의미입니다. 쉽게 말해, 파이썬 인터프리터와 NumPy 라이브러리가 호환되지 않는다는 뜻 입니다. 제 경우에는 파이썬 버전과 requirements.txt에 명시된 PyTorch, TorchVision 등 다른 라이브러리 간의 복합적인 호환성 문제였습니다.

해결 방법: 파이썬 버전 변경

여러 시도 끝에 가장 확실한 해결책은 파이썬 버전을 변경하는 것이었습니다.

1. 원인 파악: PyTorch나 다른 복잡한 라이브러리들은 특정 파이썬 버전과 호환성 제약이 있는 경우가 많습니다. 제 경우, 현재 사용하던 파이썬 버전이 requirements.txt에 있는 라이브러리들과 완벽하게 호환되지 않았던 것이 문제의 근본적인 원인이었습니다.
2. 버전 확인: PyTorch 공식 문서 등을 참고해 현재 사용하려는 라이브러리들과 가장 잘 맞는 파이썬 버전을 확인했습니다. 제가 사용하던 환경에는 Python 3.9.12가 가장 적합하다는 것을 알게 되었습니다.
3. 가상 환경(venv) 활용: 기존 시스템의 파이썬 버전을 건드리지 않고, 새로운 환경을 만들기 위해 가상 환경을 사용했습니다.
   • conda create -n my_new_env python=3.9.12
   • conda activate my_new_env
4. 라이브러리 재설치: 새로운 가상 환경에서 requirements.txt에 있는 모든 라이브러리를 다시 설치했습니다.
   • pip install -r requirements.txt

이 과정을 거치자 RuntimeError는 더 이상 발생하지 않았고, 코드가 정상적으로 실행되었습니다.

정리: 파이썬 버전 호환성 문제 해결 팁

• 오류 메시지를 꼼꼼히 읽자: RuntimeError, DeprecationWarning 등은 대부분 버전 호환성이나 잘못된 사용법에서 기인하는 경우가 많습니다.
• 가상 환경은 필수: 파이썬 프로젝트를 시작할 때는 항상 가상 환경을 만들어 관리하는 습관을 들이는 것이 좋습니다. 프로젝트마다 독립된 환경을 구축할 수 있어 버전 충돌을 방지할 수 있습니다.
• 공식 문서 확인: 사용하는 라이브러리(특히 PyTorch, TensorFlow 등)는 공식 홈페이지에서 호환되는 파이썬 버전을 명시하고 있으니, 가장 먼저 확인해보세요.