Ubuntu下已安装mysql.connector仍报ModuleNotFoundError，求助解决

云上老周

2026-7-11

问题描述

我在Ubuntu系统里想用Python连接MySQL，查资料说要先装mysql.connector模块，于是执行了命令：

pip3 install mysql.connector

之后用pip3 list | grep mysql确认模块已经装好了，但运行Python执行import mysql.connector时，弹出错误：

ModuleNotFoundError: No module named 'mysql.connector'; 'mysql' is not a package

后来我又装了这两个模块：

pip3 install mysql-connector-python
pip3 install mysql-connector-python-rf

但还是报同样的错，应该是哪里犯了基础错误，求帮忙。

可能的解决方法

检查Python与pip的环境对应关系
Ubuntu里常同时存在多个Python版本，pip3安装的模块可能和你运行的python命令不匹配。试试用python3启动交互环境再导入模块：
```
python3
```
然后执行import mysql.connector测试。也可以分别查看路径确认匹配：
```
pip3 --version
which python3
```
清理冲突模块后重装
多个mysql连接器模块共存可能引发冲突，先卸载所有相关模块：
```
pip3 uninstall mysql.connector mysql-connector-python mysql-connector-python-rf
```
卸载完成后，只安装官方维护的版本：
```
pip3 install mysql-connector-python
```
排查本地命名冲突
检查工作目录里是否有mysql.py文件或mysql文件夹，这会和第三方模块重名，导致Python优先加载本地文件而非安装的模块。如果有，重命名或删除它们。
测试全局安装（仅作排查用）
若存在用户权限问题，模块可能装在用户目录无法被系统Python读取，可尝试全局安装（注意会影响系统Python环境）：
```
sudo pip3 install mysql-connector-python
```
再用python3测试导入。