已安装mysqlclient但Django切换MySQL引擎时报错“未安装mysqlclient”

问题本质 #

你遇到的情况是：虚拟环境里mysqlclient确实安装成功，但系统层面缺少libmysqlclient.so.21这个共享库文件，导致Python加载mysqlclient依赖失败，Django因此误报出“Did you install mysqlclient?”的提示。

解决步骤 #

1. 安装系统级MySQL客户端库 #

根据你的操作系统选择对应命令执行：

• Debian/Ubuntu系统：

  sudo apt update
  sudo apt install libmysqlclient21
  

• CentOS/RHEL系统：

  sudo yum install mysql-community-libs
  

  （CentOS 8及以上版本可能需要先启用MySQL官方社区仓库）

2. 验证库文件是否到位 #

安装完成后，用以下命令确认文件已存在：

find /usr/lib -name libmysqlclient.so.21

找到文件后，重新激活虚拟环境或重启Django服务即可。

3. 备选方案（若系统包管理器找不到对应库） #

如果包管理器中搜不到libmysqlclient21，可以尝试：

• 手动下载对应版本的libmysqlclient.so.21文件，放置到系统库目录（如/usr/lib或/usr/lib64）
• 临时设置环境变量指定库路径后再启动服务：

  export LD_LIBRARY_PATH=/你存放库文件的目录:$LD_LIBRARY_PATH
  python manage.py runserver
  

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