macOS Ventura+Python3.8安装mysqlclient==2.2.0报错求助

• Python版本：3.8.18
• 操作系统：macOS Ventura 13.6.4

执行pip install mysqlclient==2.2.0时触发编译错误：

MySQLdb/_mysql.c:521:9: error: call to undeclared function 'mysql_ssl_set'

尝试降级MySQL至8.0版本、创建新虚拟环境python3.8 -m venv test_venv38、安装pkg-config（版本0.29.2）后，仍出现新错误：

Exception: Can not find valid pkg-config name.
Specify MYSQLCLIENT_CFLAGS and MYSQLCLIENT_LDFLAGS env vars manually

方法1：手动指定编译环境变量 #

1. 通过brew info mysql@8.0查看MySQL 8.0的具体安装路径，例如/usr/local/Cellar/mysql@8.0/8.0.36
2. 设置编译参数并执行安装：

export MYSQLCLIENT_CFLAGS="-I/usr/local/Cellar/mysql@8.0/8.0.36/include/mysql"
export MYSQLCLIENT_LDFLAGS="-L/usr/local/Cellar/mysql@8.0/8.0.36/lib -lmysqlclient"
pip install mysqlclient==2.2.0

也可一次性执行：

MYSQLCLIENT_CFLAGS="-I/usr/local/Cellar/mysql@8.0/8.0.36/include/mysql" MYSQLCLIENT_LDFLAGS="-L/usr/local/Cellar/mysql@8.0/8.0.36/lib -lmysqlclient" pip install mysqlclient==2.2.0

注意替换命令中的版本号为实际安装的MySQL 8.0版本号

方法2：切换到兼容的MySQL版本并刷新环境 #

1. 切换brew的MySQL版本到8.0：

brew unlink mysql
brew link mysql@8.0 --force

2. 重装pkg-config并刷新shell环境：

brew reinstall pkg-config
source ~/.zshrc  # 若使用bash则执行source ~/.bash_profile

3. 激活虚拟环境后重新安装：

source test_venv38/bin/activate
pip install mysqlclient==2.2.0

方法3：使用预编译wheel包跳过编译 #

1. 先升级pip到最新版本：

pip install --upgrade pip

2. 强制使用预编译包安装：

pip install mysqlclient==2.2.0 --only-binary :all:

若上述命令失败，可直接下载对应平台的wheel文件（如mysqlclient-2.2.0-cp38-cp38-macosx_13_0_x86_64.whl），然后本地安装：

pip install /path/to/your/downloaded/wheel/file.whl

内容的提问来源于stack exchange，提问作者mascai