You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Fedora下pip3 install mysql报metadata-generation-failed错误求助

报错根因

你遇到的编译失败和pip本身无关,核心原因是mysqlclient是基于C编写的Python扩展包,编译安装时需要调用系统提供的mysql_config/mariadb_config工具获取链接参数、头文件路径,这个工具属于系统级数据库开发组件,不在PyPI源里,升级pip、安装纯Python类的相关包都无法补上这个依赖。
Konsole和Alacritty只是终端模拟器,不会改变命令执行的逻辑和环境,不需要针对特定终端做特殊配置。

修复步骤
  • 先安装系统层面的编译依赖,执行以下命令时需要输入你的用户密码获取sudo权限:
sudo dnf install mariadb-devel python3-devel gcc
  • mariadb-devel:Fedora默认提供MariaDB兼容MySQL生态,这个包会提供mariadb_config命令,同时自动做mysql_config的兼容别名,包含编译需要的所有数据库头文件、链接库
  • python3-devel:提供Python C扩展编译所需的Python头文件
  • gcc:C语言编译器,负责编译mysqlclient的C源码
  • 系统依赖安装完成后,重新执行pip安装命令即可:
pip3 install mysql

如果你手动安装了Oracle官方版本的MySQL而不是Fedora源自带的MariaDB,把第一步里的mariadb-devel替换为mysql-devel再执行安装即可,其余步骤不变。

补充说明

你日志里的Defaulting to user installation because normal site-packages is not writeable是正常提示,不是错误,代表pip会把包装到当前用户的家目录下,不需要全局root权限,不需要额外处理。
安装完成后可以单独执行mysql_config --version验证,如果能正常输出版本字符串,就代表依赖配置正确,后续Python代码导入MySQL相关模块不会再报环境错误。

内容的提问来源于stack exchange,提问作者user18591665

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.28 15:15:18