Python3 venv环境下flask_sqlalchemy加载MySQL驱动报No module named 'MySQLdb'
问题排查解决方法
核心报错原因是SQLAlchemy默认调用MySQLdb驱动时找不到对应模块,按以下步骤逐一排查即可:
第一步:确认虚拟环境的包安装有效性
先激活你项目对应的venv虚拟环境,执行以下测试命令:python -c "import MySQLdb"如果命令报错,说明
mysqlclient安装失败,该包依赖系统层面的MySQL开发库:- Debian/Ubuntu系统需先执行
sudo apt install libmysqlclient-dev - CentOS/RHEL系统需先执行
sudo yum install mysql-devel - Windows系统需先安装对应版本的Visual C++可再发行组件包
系统依赖安装完成后,在激活的venv中重新执行pip install mysqlclient即可。
- Debian/Ubuntu系统需先执行
第二步:确认应用启动时使用的是venv的Python解释器
从报错路径/usr/local/lib/python3.9/可以看出,你当前运行应用调用的是系统全局Python,没有加载venv内安装的依赖。
激活venv后再启动应用即可,也可以直接调用venv内的解释器启动:- Linux/macOS执行:
./venv/bin/python 你的启动脚本路径.py - Windows执行:
venv\Scripts\python.exe 你的启动脚本路径.py
- Linux/macOS执行:
第三步:可选的简化替代方案
如果你不想处理mysqlclient的系统依赖,可以直接使用你已安装的mysql-connector-python驱动,只需修改SQLALCHEMY_DATABASE_URI配置前缀:
把原前缀mysql://修改为mysql+mysqlconnector://,SQLAlchemy就会自动调用mysql-connector-python驱动,不需要依赖MySQLdb模块。
注意:不要同时保留
mysqlclient和mysql-connector-python两个依赖,按需二选一即可,避免出现驱动冲突。
内容的提问来源于stack exchange,提问作者Haaris M
相关产品推荐
相关产品推荐

