Python中Django + MySQL将utf8改为utf8mb4后执行manage.py报错怎么办？

遇到这个问题，通常是因为MySQL的utf8mb4字符集与Django的默认配置不匹配。报错信息里如果提到“Unknown character set”或类似内容，那就是关键。

你需要同时修改Django项目的数据库配置和数据表本身。光改Django设置没用，已有的表结构还是旧的。下面是完整的操作步骤和代码：

1. 修改Django数据库设置（settings.py） 在DATABASES配置的OPTIONS里，明确指定字符集：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'your_db_name',
        'USER': 'your_user',
        'PASSWORD': 'your_password',
        'HOST': 'localhost',
        'PORT': '3306',
        'OPTIONS': {
            'charset': 'utf8mb4',  # 关键设置
        }
    }
}

2. 修改MySQL中已有数据库和表的字符集 登录MySQL命令行，执行以下SQL语句（将your_db_name替换为你的实际数据库名）：

-- 修改数据库默认字符集
ALTER DATABASE your_db_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;

-- 修改每张表的字符集
USE your_db_name;
ALTER TABLE your_table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

如果表很多，可以导出整个数据库再重新导入，或者写个脚本来批量修改。

3. 处理迁移文件（如果使用了Django Migrations） 如果之前用utf8生成过迁移文件，可能需要手动修改相关迁移文件中的CharField、TextField等字段定义，确保它们没有硬编码collation。不过，通常只要完成前两步，运行python manage.py migrate就能正常工作。

4. 验证连接 可以在Django shell里快速检查：

python manage.py shell
>>> from django.db import connection
>>> print(connection.connection.charset)  # 应该输出utf8mb4

常见坑点：

• 确保MySQL版本>=5.5.3，否则不支持utf8mb4。
• 如果用了第三方库或特定字段类型，检查它们是否兼容utf8mb4。
• 修改表字符集后，如果还有乱码或报错，检查连接器（如mysqlclient或pymysql）版本是否过旧。

改完这些，再跑manage.py命令应该就没问题了。核心就两步：Django配置和MySQL表结构都要改对。

总结：同时修改Django配置和MySQL表字符集。