Django MySQL数据库迁移 报错 Error loading MySQLdb module.

背景

• Django版本: Django3.3

在进行数据库迁移 python manage.py migrate 操作时报错：

django.core.exceptions.ImproperlyConfigured: Error loading MySQLdb module.Did you install mysqlclient?

问题解决

原因

Django2.2 之前版本: 没有安装 pymysql 模块，或没有配置 __init__.py 文件
Django2.2 之后版本: 没有安装 mysqlclient 模块

Django2.2 之前版本

Step 1. 检查依赖

使用下面的指令查看虚拟环境中是否安装了 pymysql

pip list

如，未安装，则使用 pip 指令安装模块

pip install pymysql

Step 2. 修改__init__.py

在项目同名的模块下的 __init__.py 文件中加入以下代码

import pymysql
pymysql.install_as_MySQLdb()

Step 3. 若此时还是报错

如果出现类类似的错误

mysqlclient 1.4.0 or newer is required; you have 0.10.1.

接下来在和项目目录同名模块的 __init__.py 中加入

import  pymysql
pymysql.version_info = (1, 4, 13, "final", 0) #指定版本
pymysql.install_as_MySQLdb()

Django2.2 之后版本

Step 1. 安装依赖

安装 mysqlclient

pip install mysqlclient

Step 2. 已安装情况下仍然报错

在和项目目录同名模块的 __init__.py 中加入

import pymysql
pymysql.install_as_MySQLdb()

或强制重装依赖

pip install mysqlclient --force-reinstall