mysql Django连接mysql步骤_mysql Python框架配置

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。