Python mysqlclient 설치 오류 해결 방법 2가지(MySQLdb)

Python에서 MySQL 데이터베이스에 엑세스할 때 사용하는 라이브러리 중에 MySQLdb가 쉽게 설치되지 않는 경우가 있습니다. Ubuntu와 Windows에서 mysqlclient 설치시에 발생하는 문제와 해결하는 방법을 함께 알아보도록 하겠습니다.

Ubuntu 환경에서 mysqlclient 설치

mysqlclient 설치 오류 상황

pip install mysqlclient
ShellScript

만약 Anaconda를 사용하면서 위와 같은 명령을 실행했는데 아래와 같은 오류가 발생하는 경우가 있습니다.

그림 1. pip install 명령어 이용시 mysqlclient 설치 오류 상황
그림 1. pip install 명령어 이용시 mysqlclient 설치 오류 상황

Anaconda 사용시 설치 오류 해결 방법

아나콘다를 사용하는 경우에는 conda install 명령어를 사용해서 설치해 주시면 됩니다.

conda install mysqlclient
ShellScript

아래와 같이 무사히 설치가 되는 것을 확인할 수 있습니다.

그림 2. conda install로 mysqlclinet 설치 성공
그림 2. conda install로 mysqlclinet 설치 성공

Anaconda를 사용하지 않는 경우

아래와 같이 Python 3 및 MySQL 개발 헤더와 라이브러리를 설치해 준 후 다시 mysqlclient를 설치해 주세요.

sudo apt install python3-dev default-libmysqlclient-dev build-essential
pip install mysqlclient
ShellScript

Windows 환경에서 에러 해결방법

Windows에서도 pip install mysqlclient 명령만을 사용하면 오류가 발생하며 설치가 안 됩니다.

Windows의 경우에는 직접 소스코드를 빌드하는 방법과 미리 빌드된 wheel을 받아서 설치하는 방법이 있습니다. 전자의 경우에는 mysqlclient 페이지에서 빌드가 잘 안되는 경우에도 지원 요청을 하지 말라고 명시하고 있으니, 빌드를 꼭 해보고 싶은 경우가 아니라면 아래에 소개된 미리 빌드해 놓은 wheel 패키지를 받아서 설치하기 바랍니다.

Christoph Gohlke의 비공식 python Binary Wheels를 어바인 캘리포니아 주립대학 페이지에 32/64bit 별로 컴파일 해 둔 웹 페이지가 있습니다. 여기에서 mysqlclient를 찾고, 자신에게 맞는 wheels 파일을 받아서 설치하시기 바랍니다.

파이썬 버전과 32비트용과 64비트 용으로 나뉘어 whl 파일이 준비되어 있습니다.

그림 3. mysqlclient 윈도우용으로 빌드된 wheel
그림 3. mysqlclient 윈도우용으로 빌드된 wheel

다운 받은 후 pip install 명령어를 사용해서 설치하면 됩니다. 만약 python 3.9를 사용하며 64비트용으로 다운 받아서 설치한다면 아래와 같이 설치하면 됩니다.

pip install mysqlclient-1.4.6-cp39-cp39-win_amd64.whl
ShellScript

Python에서 테스트

python에서 mysqlclient가 제대로 설치되었다면 import 했을 때 오류가 없어야 합니다. mysqlclient라는 이름이지만 패키지 명은 MySQLdb입니다.

import MySQLdb
ShellScript

관련자료

mysqlclient 페이지를 참고하면 보다 자세한 설명을 확인할 수 있습니다.

같이 읽으면 좋은 글

Leave a Comment