在Django项目中使用MySQL作为数据库时，除了完成基础的连接配置，还需要注意字符集相关的设置，否则很容易在管理界面提交中文数据时出现报错。本文会依次讲解MySQL数据库配置流程和问题解决方法。
Django配置MySQL数据库的基础步骤
首先需要在Django项目的settings.py文件中修改DATABASES配置项，默认的配置是SQLite，我们需要替换为MySQL的相关参数：
# settings.py 数据库配置部分
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql', # 使用MySQL数据库引擎
'NAME': 'django_db', # 数据库名称，需要提前创建
'USER': 'root', # MySQL用户名
'PASSWORD': '123456', # MySQL密码
'HOST': '127.0.0.1', # 数据库地址，本地为127.0.0.1
'PORT': '3306', # MySQL默认端口
'OPTIONS': {
'charset': 'utf8mb4', # 设置连接字符集为utf8mb4
},
}
}除了修改Django配置，还需要提前安装MySQL的Python驱动，推荐使用mysqlclient，可以通过pip命令安装：
pip install mysqlclient
管理界面提交中文错误的常见原因
完成基础配置后，如果在Django管理界面提交包含中文的数据时提示错误，通常有以下三类原因：
1. MySQL数据库字符集设置不正确
如果创建数据库时没有指定字符集，MySQL会使用默认字符集，很可能是latin1，这种情况下无法存储中文数据，提交时就会报错。正确的建库语句需要指定字符集和排序规则：
-- 创建支持中文的数据库 CREATE DATABASE django_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
2. Django配置中未指定连接字符集
即使数据库字符集正确，如果Django连接MySQL时没有指定charset参数，连接使用的字符集可能不符合要求，也会导致中文提交失败，需要在OPTIONS中添加'charset': 'utf8mb4'配置，如上文的基础配置所示。
3. 模型字段未正确设置
在定义Django模型时，如果字符类型的字段没有使用合适的参数，也可能出现问题，不过Django的CharField和TextField默认支持中文，只要数据库和连接配置正确，一般不需要额外修改，示例如下：
# models.py 示例模型
from django.db import models
class Article(models.Model):
title = models.CharField(max_length=100, verbose_name="文章标题") # 支持中文标题
content = models.TextField(verbose_name="文章内容") # 支持中文内容
create_time = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")
def __str__(self):
return self.title
class Meta:
verbose_name = "文章"
verbose_name_plural = "文章"问题排查与验证方法
如果按照上述步骤配置后仍然有问题，可以按照以下流程排查：
- 首先检查数据库字符集，登录MySQL后执行
SHOW CREATE DATABASE django_db;，查看字符集是否为utf8mb4 - 检查Django的
settings.py中DATABASES配置的OPTIONS是否包含charset参数 - 尝试在MySQL命令行中直接插入中文数据，验证数据库本身是否支持中文存储
- 查看Django运行时的报错日志，根据具体的错误信息定位问题，比如如果是字段长度不足导致的错误，需要修改模型字段的
max_length参数
完成所有配置后，启动Django项目，访问管理界面，添加包含中文的模型数据，如果能够正常保存且没有报错，说明问题已经解决。