Apple Silicon macOS 14.3下pip安装mysqlclient报未声明函数错误

问题分析 #

你遇到的编译错误（mysql_ssl_set、mysql_kill、mysql_shutdown函数未声明），核心原因是当前安装的mysql-client 8.3.0轻量库与mysqlclient的编译逻辑不兼容，或者编译环境缺少必要的宏定义/头文件路径配置。

解决方案 #

方法1：升级mysqlclient到最新兼容版本 #

尝试安装最新版的mysqlclient，新版本通常会适配更高版本的MySQL客户端库：

pip install --upgrade mysqlclient

方法2：替换为完整MySQL包并配置编译环境 #

1. 卸载轻量版mysql-client，安装完整的MySQL包：

brew uninstall mysql-client
brew install mysql

2. 设置编译环境变量，指定头文件路径并启用必要宏定义：

export CFLAGS="-I$(brew --prefix mysql)/include -DMYSQL_CLIENT_NO_DEPRECATED"
export LDFLAGS="-L$(brew --prefix mysql)/lib"
pip install mysqlclient

方法3：验证pyenv Python架构兼容性 #

由于你使用pyenv管理Python，确保当前Python版本是针对Apple Silicon（arm64）编译的：

python -c "import platform; print(platform.machine())"

如果输出为x86_64，说明使用了Rosetta转译，需重新安装arm64架构的Python：

PYENV_CONFIGURE_OPTS="--with-openssl=$(brew --prefix openssl)" pyenv install 3.11.6

方法4：手动指定pkg-config路径 #

强制pkg-config识别完整MySQL包的配置文件：

export PKG_CONFIG_PATH="$(brew --prefix mysql)/lib/pkgconfig"
pip install mysqlclient

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