Mac环境下pip安装mysql遇metadata-generation-failed错误求助

问题概述 #

执行pip install mysql或pip3 install mysql时出现以下错误：

• subprocess-exited-with-error：错误源于子进程，非pip本身问题
• metadata-generation-failed：生成包元数据失败，问题出在mysql包本身

解决步骤 #

1. 替换为官方维护的MySQL Python驱动包
   mysql这个PyPI包已不再被官方维护，是导致错误的核心原因，改用以下两个主流驱动之一：

• 安装MySQL官方连接器：

  pip3 install mysql-connector-python
  

• 或者安装轻量兼容的PyMySQL（可替代MySQLdb）：

  pip3 install pymysql
  

2. 处理系统编译依赖（若仍有报错）
   如果安装驱动时出现编译相关错误，先通过Homebrew安装MySQL开发依赖：

brew install mysql-client

临时设置环境变量让pip识别依赖（当前终端会话有效）：

export PATH="/usr/local/opt/mysql-client/bin:$PATH"
export LDFLAGS="-L/usr/local/opt/mysql-client/lib"
export CPPFLAGS="-I/usr/local/opt/mysql-client/include"

之后重新执行驱动安装命令。

3. 升级pip到最新版本
   旧版pip可能存在元数据处理兼容性问题，先升级：

pip3 install --upgrade pip

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