如何在Python Django中解决MySQL字符集导致的乱码问题？-Python教程-PHP中文网

mysql默认字符集应设为utf8mb4，因其支持4字节unicode字符（如emoji、生僻汉字），而utf8仅支持3字节；需同步配置服务端my.cnf、客户端连接及已有表结构，并在django中通过options指定charset=utf8mb4。

如何在python django中解决mysql字符集导致的乱码问题？

确认MySQL连接默认字符集是否为utf8mb4

Django默认用utf8连接MySQL，但MySQL的utf8实际只支持3字节UTF-8字符（不支持emoji、部分生僻汉字），真正该用的是utf8mb4。如果数据库表字符集是utf8mb4，而Django连接时没指定，就会出现写入正常、读取乱码，或保存emoji时报Incorrect string value错误。

检查方法：在MySQL命令行执行SHOW VARIABLES LIKE 'character_set%';，重点看character_set_client、character_set_connection、character_set_results是否都为utf8mb4；如果不是，光改Django配置没用。

在settings.py的DATABASES配置里显式加上'OPTIONS': {'charset': 'utf8mb4'}

确保MySQL服务端配置文件（如/etc/mysql/my.cnf）中包含：

[client]
default-character-set = utf8mb4
[mysql]
default-character-set = utf8mb4
[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

重启MySQL服务后，用mysql -u root -p -e "SHOW VARIABLES LIKE 'character_set%';"验证

迁移已有表和列到utf8mb4

即使连接层设对了，旧表可能还是utf8字符集，字段长度限制（比如VARCHAR(255)在utf8mb4下实际占用更多空间）也可能导致索引失败或ALTER报错。

直接执行ALTER TABLE xxx CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;有风险：若表大、有外键、或存在TEXT字段，可能锁表或失败。

先备份：mysqldump -u root -p --default-character-set=utf8mb4 dbname > backup.sql
对每个表单独转换，优先处理带索引的VARCHAR字段：ALTER TABLE myapp_mymodel CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
若提示Specified key was too long，说明索引长度超限（utf8mb4单字符占4字节，原VARCHAR(255)索引最多支持191字符），需先收缩字段：ALTER TABLE myapp_mymodel MODIFY title VARCHAR(191) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Django模型字段声明无需额外编码参数

很多人误以为要在CharField里加db_collation或手动指定编码，其实Django 3.2+已自动适配utf8mb4连接，只要数据库层和连接层都设对，模型本身不需要任何修改。

python 查询技能

查询客流数据，输出JSON格式，可直接导入Bitable等可视化工具

下载

唯一要注意的是：如果字段需要区分大小写（比如用户名唯一校验），MySQL默认utf8mb4_unicode_ci是大小写不敏感的，这时可改用utf8mb4_bin排序规则，但必须在建表/改表时指定，不能靠Django字段参数控制。

CharField、TextField等保持原样即可，不要加encoding='utf8mb4'之类无效参数
如需二进制精确匹配，在MySQL里执行：ALTER TABLE myapp_mymodel MODIFY username VARCHAR(150) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
Django迁移不会自动同步collation变更，这类调整必须手工执行SQL

验证乱码是否真由字符集引起

不是所有中文显示为问号或都是字符集问题——也可能是模板渲染时HTTP响应头缺失Content-Type: text/html; charset=utf-8，或前端HTML没写<meta charset="utf-8">，甚至Python源文件本身没声明# -*- coding: utf-8 -*-。

快速定位：用mysql -u root -p -e "SELECT HEX(title) FROM myapp_mymodel LIMIT 1;"查原始十六进制值。如果是乱码，看到的会是类似EDB6A7（UTF-8编码的“中”字），但如果显示成EFBFBD（Unicode替换符），说明数据入库时已被损坏，只能从备份恢复。