Django添加含阿拉伯字符记录时出现OperationalError问题排查

问题根源 #

你遇到的1366错误，核心原因是MySQL的utf8字符集并非完整UTF-8——它实际是utf8mb3，仅支持最多3字节的Unicode字符，无法存储某些特殊阿拉伯字符（或包含4字节编码的字符）。同时当前数据库配置、数据库及表的字符集不匹配，导致写入时出现编码冲突。

具体修复步骤 #

不需要重新创建数据库，按以下步骤操作即可：

1. 修改Django数据库配置
   将settings.py里数据库OPTIONS中的字符集替换为utf8mb4（完整UTF-8实现）：

   DATABASES = {  
       'default': {  
           'ENGINE': 'django.db.backends.mysql',  
           'NAME': '*****_db',  
           'USER': '******',  
           'PASSWORD': '********',  
           'HOST': 'localhost',  
           'PORT': '3306',  
           'OPTIONS': { 
               'init_command': 'SET storage_engine=INNODB,character_set_connection=utf8mb4,collation_connection=utf8mb4_unicode_ci'
           }
       }  
   }
   

2. 修正数据库与表的字符集
   登录MySQL执行以下命令（替换asiatrad_db为你的数据库名，courses_arguments为报错的表名）：

   • 查看当前数据库字符集：

     SHOW CREATE DATABASE asiatrad_db;
     

   • 修改数据库默认字符集：

     ALTER DATABASE asiatrad_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
     

   • 转换目标表的字符集（该命令会自动更新表内所有列的字符集）：

     ALTER TABLE courses_arguments CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
     

补充说明 #

• utf8mb4是MySQL对完整UTF-8的标准实现，支持所有Unicode字符（包括阿拉伯语扩展字符、emoji等），是存储多语言内容的最优选择。
• 若后续创建新表，只要数据库默认字符集已设为utf8mb4，Django的迁移操作会自动让新表继承该字符集设置。

内容的提问来源于stack exchange，提问作者Alireza javanpour