如何通过Django模型CharField字段直接设置数据库列collate

原生方案（最推荐） #

Django 4.2及以上版本原生就支持给字符串字段单独指定数据库列的排序规则，不需要安装任何第三方包。官方参数名是db_collation，不是示例里写的collate，配置方式如下：

from django.db import models

class BizModel(models.Model):
    name = models.CharField(
        max_length=255,
        db_index=True,
        db_collation='utf8_general_ci'
    )

写完正常执行makemigrations生成迁移，框架会自动给这一列单独设置指定的collate，完全不会影响表默认的utf8mb4_general_ci配置。

4.2以下低版本兼容方案 #

如果用的是早于4.2的Django版本，没有原生参数支持，可以选两种实现方式：

• 自定义支持collate参数的字段
  继承原生CharField重写db_type方法，在返回的字段类型定义里追加COLLATE声明即可，写完就能按预期的方式传参：

  from django.db import models
  
  class CharFieldWithCollate(models.CharField):
      def __init__(self, *args, collate=None, **kwargs):
          self.collate = collate
          super().__init__(*args, **kwargs)
  
      def db_type(self, connection):
          origin_db_type = super().db_type(connection)
          if self.collate:
              return f"{origin_db_type} COLLATE {self.collate}"
          return origin_db_type
  
  # 使用示例
  class BizModel(models.Model):
      name = CharFieldWithCollate(max_length=255, db_index=True, collate='utf8_general_ci')
  

• 迁移文件手动加SQL
  生成初始迁移后，在迁移文件里加RunSQL操作，执行ALTER语句单独修改对应列的collate。这种方式不用改字段定义，但后续字段调整的时候容易漏配置，只适合临时调整的场景。

第三方库相关 #

早期有个面向MySQL后端的Django第三方扩展库曾提供过字段级collate配置的能力，但Django 4.2推出原生支持之后，这个功能就没必要用第三方库实现了，额外加依赖反而会增加维护成本。

踩坑提醒：utf8_general_ci对应的是MySQL里的utf8mb3（也就是常说的不完整utf8）字符集，不支持emoji、部分生僻字等四字节Unicode字符，如果这个字段需要存这类内容，不要配这个collate，不然会出现存储失败、字符截断的问题。

内容的提问来源于stack exchange，提问作者Tommaso Castellani