Python安装多种mysql依赖后仍报No module named 'mysql' 求问题排查

已尝试的操作记录 #

• 执行 pip install mysqlclient 安装
• 执行 pip install mysql-connector 安装
• 执行 pip install mysql-connector-python 安装
• 执行 pip install -U setuptools 升级构建工具
• 系统检索不到 mysql-connector-python-rf 安装包

常见故障原因及对应处理方法 #

1. pip 与实际运行脚本的 Python 环境不匹配 #

这是最频发的场景：系统中存在多版本Python、使用虚拟环境时未激活、pip命令绑定的解释器和执行脚本的解释器不是同一个，导致包被装到了其他Python的路径下，运行脚本时找不到对应模块。

• 验证方法：使用运行脚本的解释器直接执行 python -m pip list，查看输出列表中是否存在已安装的mysql相关包，不要直接调用全局pip命令查询
• 处理方法：安装所有依赖时，统一使用当前运行脚本的Python解释器 -m pip install 包名的格式执行，避免直接调用全局pip；如果使用虚拟环境，先激活虚拟环境再执行安装操作。

2. 模块导入路径与实际环境不匹配 #

不同MySQL驱动的导入规则存在差异，安装完成后如果按照错误的导入语句写代码、或存在路径干扰，即使包安装成功也会触发模块找不到的报错：

• mysqlclient 安装完成后，正确的导入语句为 import MySQLdb，不支持import mysql的写法
• mysql-connector-python 安装完成后，顶层模块为mysql包，正确的导入语句为 import mysql.connector
• 老旧弃用的mysql-connector包在Linux环境下会生成大写的MySQL目录，因Linux路径大小写敏感，执行import mysql时会因路径不匹配找不到模块
• 若本地脚本文件名命名为mysql.py、或当前运行目录下存在同名的mysql.py文件，Python解释器会优先加载当前目录下的同名文件，不会加载系统安装的mysql驱动模块
• 处理方法：根据实际安装的驱动库修改对应导入语句，卸载已弃用的老旧mysql-connector包，将本地重名的测试脚本改名后再运行。

3. 安装过程静默失败 #

MySQL驱动类包安装时依赖系统级的编译库，若缺少依赖会导致pip安装中断，很多用户未留意安装输出的报错信息，默认操作完成：

• mysqlclient 在Linux环境下需要提前安装libmysqlclient-dev（Debian/Ubuntu系）、mysql-devel（RHEL/CentOS系）系统依赖，Windows环境下需要匹配对应Python版本的预编译安装包，缺少依赖时安装会直接中断
• 验证方法：重新执行安装命令时加-v参数查看完整输出，确认最后有Successfully installed开头的成功提示，若安装中断需先补全对应系统依赖再重试。

4. pip 软件源异常导致包检索失败 #

无法检索到mysql-connector-python-rf包，大概率是当前使用的第三方pip源未同步该包信息、或源地址失效：

• 处理方法：安装时临时切换到PyPI官方源地址执行安装命令；若官方源也检索不到该包，说明该包已归档下架，无需额外安装，直接使用官方维护的mysql-connector-python即可。

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