群晖服务器安装mysql-connector-python后，普通用户运行脚本报错No module named 'mysql.connector'

问题原因 #

你用sudo python3 -m pip install mysql-connector-python安装模块时，模块是装在root用户专属的Python环境里的，普通用户myuser的Python环境并没有这个模块，所以运行脚本时会提示No module named 'mysql.connector'，而root用户能正常运行是因为它能访问自己环境里的模块。

解决方案 #

方法1：给myuser单独安装模块（简单直接）

直接以myuser身份登录，运行不带sudo的安装命令，加上--user参数把模块装到个人目录：

python3 -m pip install mysql-connector-python --user

安装完成后，myuser运行脚本就能正常导入模块了。

方法2：使用虚拟环境（推荐，隔离依赖）

虚拟环境能避免全局环境的依赖冲突，步骤如下：

1. 以myuser身份创建虚拟环境：

python3 -m venv myenv

2. 激活虚拟环境：

source myenv/bin/activate

3. 在激活的环境里安装模块：

pip install mysql-connector-python

4. 之后运行脚本时，要么先激活虚拟环境，要么直接用虚拟环境里的Python解释器执行：

myenv/bin/python3 your_script.py

方法3：修改全局模块权限（不推荐）

如果一定要用root安装的全局模块，可以修改模块目录的权限，让myuser能访问：

# 替换pythonX.X为你实际的Python版本，比如python3.9
sudo chmod -R o+rX /usr/local/lib/pythonX.X/site-packages/mysql
sudo chmod -R o+rX /usr/local/lib/pythonX.X/site-packages/mysql_connector_python-*.dist-info

这种方法可能影响系统全局环境，除非必要不建议使用。

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