安装mysql-connector后仍报mysql module not found错误问题咨询

核心原因 #

该问题本质是Python多环境路径不匹配：你执行pip安装命令时用的Python环境，和你运行脚本时调用的Python解释器不属于同一个环境，依赖只安装在了前者的库目录中，后者无法读取到对应的包。

解决步骤 #

• 第一步：确认两个环境的路径差异

  1. 在你执行pip安装命令的shell中执行对应命令，获取当前shell默认Python路径：
     • Linux/macOS 执行：which python3
     • Windows 执行：where python
  2. 在报错的脚本开头添加以下代码并运行，获取脚本实际使用的Python解释器路径：

     import sys
     print(sys.executable)
     

  对比两个输出的路径，如果不一致即可确认是环境不匹配问题。

• 第二步：将依赖安装到脚本对应的Python环境
  使用上一步查到的脚本对应Python解释器的绝对路径执行安装命令，格式如下：

  你的Python解释器绝对路径 -m pip install mysql-connector-python
  

  示例（假设路径为/usr/local/bin/python3.10）：

  /usr/local/bin/python3.10 -m pip install mysql-connector-python
  

• 第三步：清理冲突包（必做）
  mysql-connector和mysql-connector-python两个包同时安装会产生冲突，先执行卸载命令清理：

  你的Python解释器绝对路径 -m pip uninstall -y mysql-connector mysql-connector-python
  

  卸载完成后重复第二步的安装命令，单独安装mysql-connector-python即可。

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