执行pipenv install mysqlclient遇RuntimeError: Failed to lock Pipfile.lock错误求解决

报错核心信息 #

执行pipenv install mysqlclient后，mysqlclient本身安装成功，但Pipenv在更新Pipfile.lock时失败，核心报错内容：

ERROR:pip.subprocessor:获取构建wheel的需求时退出，状态码1
[pipenv.exceptions.ResolutionFailure]: 警告：无法解析您的依赖项，您的子依赖项可能存在版本不匹配。
RuntimeError: Failed to lock Pipfile.lock!

解决方法 #

1. 绕过Pipenv锁机制先安装，再手动生成锁文件 #

根据报错提示的临时方案，先直接通过pip安装mysqlclient，再保留现有依赖版本生成锁文件：

# 在虚拟环境中直接安装mysqlclient
pipenv run pip install mysqlclient
# 基于已安装的依赖版本生成锁文件
pipenv lock --keep-outdated

2. 安装macOS下mysqlclient的编译依赖 #

mysqlclient需要MySQL客户端库才能完成编译，macOS下可通过Homebrew安装：

# 安装MySQL客户端依赖
brew install mysql-client
# 设置环境变量，让编译工具找到依赖文件
export PATH="/usr/local/opt/mysql-client/bin:$PATH"
# 重新尝试锁定依赖
pipenv lock

3. 指定兼容Python3.12的mysqlclient版本 #

Python3.12对旧版mysqlclient兼容性较差，指定明确支持3.12的版本（2.2.0及以上）：

1. 打开项目中的Pipfile，修改mysqlclient的版本声明：

   [packages]
   mysqlclient = ">=2.2.0"
   

2. 重新执行锁定命令：

   pipenv lock
   

4. 升级Pipenv到最新版本 #

旧版Pipenv的依赖解析器可能存在bug，升级到最新版本修复问题：

pip install --upgrade pipenv
# 重新尝试安装并锁定依赖
pipenv install mysqlclient

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