已安装mysqlclient，uwsgi启动Django仍报MySQLdb模块缺失错误

这问题我踩过好几次坑，核心原因基本都是uWSGI没用到你装了mysqlclient的虚拟环境Python解释器，具体分这几种常见情况，对应解决办法如下：

• uWSGI默认调用了系统全局Python，而非虚拟环境的
  你是在虚拟环境里安装的mysqlclient，但如果uWSGI是系统全局安装的，它默认会用系统自带的python3，而系统Python的site-packages里根本没装这个包，自然会抛出找不到_mysql的错误。
  解决办法：启动时明确指定虚拟环境的Python路径，或者在uwsgi配置文件里加参数：

  • 临时启动时指定：uwsgi --ini uwsgi.ini --home /path/to/your/venv
  • 永久配置到uwsgi.ini：在配置文件中添加home = /path/to/your/venv（这个参数会让uWSGI完整加载虚拟环境的所有依赖）

• uWSGI是在虚拟环境外安装的，没关联虚拟环境的依赖
  如果你的uWSGI是用系统pip安装的，它不会自动识别虚拟环境的site-packages目录，哪怕你激活了虚拟环境再启动uWSGI，它还是会用自己关联的系统Python依赖。
  解决办法：先激活你的虚拟环境，然后在虚拟环境内重新安装uWSGI：

  source /path/to/your/venv/bin/activate
  pip install uwsgi
  

  之后用虚拟环境bin目录下的uWSGI启动项目：/path/to/your/venv/bin/uwsgi --ini uwsgi.ini，这样它就会完全使用虚拟环境的Python和所有安装的包了。

• 虚拟环境路径配置异常（比如软链接或路径错误）
  少数情况下，虚拟环境的Python可能是软链接到系统Python，但site-packages是独立目录，uWSGI可能没正确读取到虚拟环境的site-packages路径。
  解决办法：在uwsgi.ini里明确指定site-packages路径：

  pythonpath = /path/to/your/venv/lib/pythonX.X/site-packages
  

  把X.X替换成你的Python版本（比如3.9、3.10），确保uWSGI能直接找到mysqlclient的安装位置。

• 特殊情况：mysqlclient编译依赖缺失
  如果你的mysqlclient是在虚拟环境里编译安装的，而uWSGI运行的环境缺少MySQL开发库（比如libmysqlclient-dev），也可能导致_mysql模块加载失败。不过这种情况一般Django runserver也会报错，除非uWSGI和runserver的运行环境有差异（比如不同用户、容器环境）。
  解决办法：在uWSGI运行的系统中安装MySQL开发依赖：

  • Ubuntu/Debian：sudo apt-get install libmysqlclient-dev
  • CentOS/RHEL：sudo yum install mysql-devel

内容的提问来源于stack exchange，提问作者sof-03