에러 메시지 설명
ImportError: DLL load failed when importing cv2 오류는 OpenCV를 사용하여 cv2 모듈을 임포트할 때 발생하는 문제입니다. 이 오류는 주로 OpenCV의 필요한 DLL(동적 링크 라이브러리)이 로드되지 않았거나 누락되었을 때 발생합니다. Windows 환경에서 흔하게 발생하는 문제로, 시스템 설정이나 패키지 설치 문제로 인해 OpenCV 모듈이 정상적으로 동작하지 않습니다.
발생 원인
이 오류는 다음과 같은 여러 가지 이유로 발생할 수 있습니다:
- Python과 OpenCV 버전 불일치: Python 버전과 설치된 OpenCV 버전이 호환되지 않을 때 발생할 수 있습니다.
- 필수 DLL 파일 누락: OpenCV가 정상적으로 설치되지 않았거나, 설치 중 필요한 DLL 파일이 누락되었을 수 있습니다.
- Python 환경 문제: 가상 환경을 사용 중일 때, OpenCV 패키지가 해당 환경에 설치되지 않았거나 충돌이 발생할 수 있습니다.
- 시스템 환경 변수 문제: 시스템 경로(PATH) 설정에 필요한 라이브러리 경로가 빠져 있는 경우.
해결 방법
OpenCV 재설치
OpenCV 설치에 문제가 있을 수 있으므로, 먼저 OpenCV 패키지를 다시 설치해 봅니다. 터미널 또는 명령 프롬프트에서 다음 명령어로 OpenCV를 재설치합니다.
pip uninstall opencv-python opencv-contrib-python
pip install opencv-python opencv-contrib-python
Python과 OpenCV 버전 확인
Python 버전과 OpenCV 버전이 호환되지 않으면 오류가 발생할 수 있습니다. Python 64비트 버전을 사용하고 있는지 확인하고, OpenCV가 동일한 비트 버전에서 설치되었는지 확인하세요.
import platform
print(platform.architecture())platform.architecture()가 ('64bit', 'WindowsPE')를 반환하는지 확인한 후, 64비트 환경에서 OpenCV가 설치되었는지 확인하세요.
시스템 환경 변수 수정
필수 라이브러리가 시스템 경로(PATH)에 없을 경우, OpenCV의 DLL 파일을 로드하지 못할 수 있습니다. 필요한 경우 OpenCV 설치 경로를 시스템 환경 변수에 추가해 줍니다.
- Windows
- "시스템 속성 > 고급 시스템 설정 > 환경 변수"로 이동합니다.
- "시스템 변수"에서 Path를 찾아 OpenCV가 설치된 폴더 경로(예: C:\opencv\build\x64\vc15\bin)를 추가합니다.
Visual C++ Redistributable 설치
OpenCV는 Visual Studio에서 컴파일되었기 때문에, Microsoft Visual C++ Redistributable이 설치되어 있어야 정상 작동할 수 있습니다. Microsoft 공식 웹사이트에서 최신 Visual C++ Redistributable을 설치합니다.
관련 내용 및 추가 팁
- Python 버전 확인: Python 32비트와 64비트 버전이 혼용되어 사용되는 경우가 없도록 주의하세요.
- 필수 의존성 확인: OpenCV는 numpy와 같은 필수 패키지가 설치되지 않았을 경우 작동하지 않을 수 있으니 함께 설치 여부를 확인하세요.
- OpenCV 공식 문서
- PyPI opencv-python 페이지
