Django连接MySQL需安装mysqlclient（推荐）或PyMySQL（备选），并在settings.py中正确配置ENGINE为'django.db.backends.mysql'、charset为'utf8mb4'等参数，同时确保MySQL服务可访问、用户权限正确、认证协议兼容。
确认 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。
