Python/Debugging

OpenCV 임포트 과정에서 ImportError: libGL.so.1: cannot open shared object file: No such file or directory 오류 해결법

jimmy_AI 2025. 6. 15. 16:48
반응형

안녕하세요.

이번 글에서는 파이썬에서 cv2 모듈을 import하는 과정에서 발생 가능한

ImportError: libGL.so.1: cannot open shared object file: No such file or directory

오류를 해결하는 방법을 간략하게 다루어보도록 하겠습니다.

 

 

오류 개요

python에서 cv2 모듈을 임포트하는 과정에서

다음과 같은 오류 메시지가 발생하였습니다.

import cv2

ImportError: libGL.so.1: cannot open shared object file: No such file or directory

 

이는 opencv 모듈을 활용하기 위한 libgl1 패키지 중 누락이 있어 발생하는 오류입니다.

 

 

해결 방법

우분투 기준, 다음과 같은 명령어로 관련 라이브러리를 설치해주면 해결됩니다.

sudo apt-get update
sudo apt-get install libgl1 libglvnd0 libgl1-mesa-dri libglu1-mesa libglx-mesa0

 

CentOS/Fedora/RHEL 계열에서는 다음과 같은 명령어로 설치가 가능합니다.

# yum 사용 시
sudo yum install mesa-libGL

# dnf 사용 시
sudo dnf install mesa-libGL

 

이 글이 cv2 모듈 임포트 오류 해결에 도움이 되셨기를 기원합니다.

감사합니다.