使用pip安装mysql-python报错：Django项目MySQL连接依赖安装失败
2026-5-26
解决Python3环境下安装mysql-python报错的问题
嘿，我来帮你搞定这个坑！你遇到的报错核心原因很简单：mysql-python这个包只支持Python 2，而你用的是Python 3（从你使用pip3就能看出来），而且这个包已经停止维护好几年了，完全不适合现在的Python3项目，所以安装必然失败。
下面给你两个靠谱的替代方案，都是Django官方认可的MySQL连接库：
方案一：安装mysqlclient（官方推荐，性能最优）
这是mysql-python的Python3分支版本，基于C扩展实现，性能和原生库一致，是Django官方首推的选择。不过安装前需要先配置系统层面的依赖：
针对Ubuntu/Debian系统：
先安装系统依赖：
sudo apt-get install python3-dev default-libmysqlclient-dev build-essential
再安装Python包：
pip3 install mysqlclient
针对CentOS/RHEL系统：
先装系统依赖：
sudo yum install python3-devel mysql-devel gcc
再安装Python包：
pip3 install mysqlclient
方案二：使用pymysql（纯Python实现，无需编译）
如果装mysqlclient遇到编译问题（比如环境复杂、缺少编译工具），可以用pymysql——它是纯Python编写的MySQL客户端，不需要编译就能快速安装：
- 先安装包：
pip3 install pymysql
- 在你的Django项目根目录的
__init__.py文件里添加以下代码，让Django把pymysql识别为兼容MySQLdb的库：
import pymysql pymysql.install_as_MySQLdb()
配置完成后，你的Django项目就能正常连接MySQL数据库啦！
内容的提问来源于stack exchange，提问作者Julio Amorim
相关产品推荐
相关产品推荐
