[Ubuntu] mysqlclient 설치 시 'get_requires_for_build_wheel' 오류 해결

AWS RDS로 DB를 생성하고 Django settings.py에 관련 모듈에 대한 정보를 업데이트 해주었다.

업데이트 된 settings.py 내용을 WAS 서버에서 업데이트 해주고, 적용하려면 mysqlclient 모듈을 설치해야 했다.

그런데 AWS EC2로 만든 WAS서버에서 mysqlclient 모듈을 설치하려는데 계속 오류가 발생했다.

구글링해가며 오류를 해결했고, 그 과정을 기록해두고자 한다!

---

기본 정보

기본 정보
서버: AWS EC2
OS: Ubuntu 20.04
설치하려는 모듈: mysqlclient

오류 내용

ec2서버의 가상환경에서 pip install mysqlclient 명령어로 모듈을 설치하면 위와 같은 에러가 발생한다.

ERROR: Command errored out with exit status 1: /home/ubuntu/.venv/bin/python3 /tmp/tmpm5inhfko get_requires_for_build_wheel /tmp/tmph_bigv8x Check the logs for full command output.

--verbose 옵션으로 에러를 확인해봐도 같은 메세지를 출력한다.

1. sudo 권한으로 설치해보기 (실패)

간혹 root 권한으로 설치해야한다는 말이 있어서 명령어 앞에 sudo 를 붙여서 시도해보았다.

동일한 에러가 계속 발생한다.

2. pip 버전 변경 (실패)

pip 버전과 모듈 버전이 맞지 않아서 문제가 발생하기도 한다고 한다.

pip버전을 다운그레이드하고 다시 시도해보았다.

Specify MYSQLCLIENT_CFLAGS and MYSQLCLIENT_LDFLAGS env vars manually

위 오류가 새롭게 발생한다.

3. pkg-config 패키지 설치 (성공)

새로운 오류로 검색하면서 해결방법을 찾았다!

설치하고자하는 mysqlclient 2.2.0버전이 23년 6월 22일에 새로 릴리스되었다고 한다.

이번 버전(2.2.0)부터 설치 시 pkg-config 패키지 추가 설치가 필요하다고 한다!!

sudo apt install default-libmysqlclient-dev pkg-config -y
pip install mysqlclient

위 명령어로 pkg-config 모듈을 먼저 설치해준 후 mysqlclient 모듈을 설치하면 된다 ㅎㅎ

pkg-config를 설치할 때 패키지 오류가 발생하면 sudo apt-get update 명령어를 실행하고 다시 해보면 된다.

설치 성공!

---

참고

https://www.sysnet.pe.kr/2/0/13377