确认 Django 项目已安装 mysqlclient 或 PyMySQL
Django 默认不自带 MySQL 驱动，必须手动安装兼容的 Python 包。用
mysqlclient是官方推荐（C 扩展、性能好、兼容性强），
PyMySQL是纯 Python 实现（调试方便、无编译依赖，但慢一点、部分新特性支持滞后）。
常见错误：直接 pip install mysql 就报错——因为没有叫
mysql的包；或者装了
mysql-connector-python却没在
settings.py中配置对应引擎，导致
django.core.exceptions.ImproperlyConfigured: 'mysql' isn't an available database backend。 推荐执行：
pip install mysqlclient（Linux/macOS 需先装
mysql-devel或
libmysqlclient-dev；Windows 用户建议用预编译 wheel） 备选（仅开发/测试）：
pip install PyMySQL，并在项目
__init__.py（如
myproject/myproject/__init__.py）中添加：
import pymysql pymysql.install_as_MySQLdb()
Django settings.py 中正确配置 DATABASES
不是改
HOST和
NAME就完事——Django 对 MySQL 后端有隐含要求：字符集、时区、连接参数稍有偏差就可能引发中文乱码、时区错位、连接复用失败等问题。
关键点：
ENGINE必须是
'django.db.backends.mysql'，不能写成
'mysql'或
'pymysql'；
PORT默认是
3306，显式写出更稳妥；
OPTIONS建议加
'charset': 'utf8mb4'支持 emoji。
立即学习“Python免费学习笔记（深入）”；
最小可用配置示例：DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'mydb',
'USER': 'root',
'PASSWORD': '123456',
'HOST': '127.0.0.1',
'PORT': '3306',
'OPTIONS': {
'charset': 'utf8mb4',
},
}
}生产环境建议加：'OPTIONS': {
'charset': 'utf8mb4',
'init_command': "SET sql_mode='STRICT_TRANS_TABLES'",
'autocommit': True,
}注意：
init_command在 mysqlclient ≥ 2.0 中已被弃用，若报错可删掉；
autocommit=True可避免长事务卡死连接池。
验证连接前先确保 MySQL 服务可访问且用户权限正确
Django 报
django.db.utils.OperationalError: (2003, "Can't connect to MySQL server...")，90% 不是代码问题，而是网络或权限问题。 用命令行直连验证：
mysql -h 127.0.0.1 -P 3306 -u root -p检查用户是否允许从该 host 连接（尤其是 Docker 或远程部署）：
SELECT host, user FROM mysql.user WHERE user = 'root';，若只显示
'localhost'，需执行：
CREATE USER 'root'@'%' IDENTIFIED BY '123456'; GRANT ALL PRIVILEGES ON *.* TO 'root'@'%'; FLUSH PRIVILEGES;检查 MySQL 是否监听外部地址（
bind-address在
/etc/mysql/mysql.conf.d/mysqld.cnf中，默认可能是
127.0.0.1）
运行 migrate 前先执行 python manage.py dbshell 测试
别急着
migrate，先用
dbshell看 Django 能否真正建连并执行 SQL。它会调用你配置的驱动，暴露底层真实错误（比如认证插件不兼容、SSL 强制开启等）。
典型报错：
django.db.utils.OperationalError: (1251, "Client does not support authentication protocol requested by server...")，说明 MySQL 8+ 默认用
caching_sha2_password，而旧版 mysqlclient 不支持。解决方法是在 MySQL 中重置用户认证方式：
ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY '123456'; FLUSH PRIVILEGES;
如果
dbshell成功进入 MySQL 提示符，再跑
python manage.py migrate才算真正过了一关。
最后提醒：MySQL 8.0.28+ 默认启用
require_secure_transport，Docker 或本地开发时容易被忽略，导致连接拒绝——临时关闭可在 my.cnf 加
require_secure_transport=OFF，但线上务必配好 SSL。
