Flask Mongoengine如何实现不区分大小写的字段唯一性校验

直接在模型层做统一归一化处理，完全不需要修改任何视图层代码，所有写入场景自动生效，不会漏逻辑。 #

方案一：利用Document内置clean钩子（改造成本最低） #

Mongoengine 每次执行save()操作前会自动调用模型的clean方法做数据校验/清洗，直接在这个方法里统一做小写转换即可，你的auth.py代码完全不用动。
修改后的models.py代码如下：

from flask_mongoengine import MongoEngine

db = MongoEngine()

class User(db.Document):
    email = db.EmailField(
        unique = True,
        required = True
    )
    username = db.StringField(
        unique = True,
        required = True
    )
    password = db.StringField(
        required = True
    )

    def clean(self):
        # 写入前自动归一化格式，所有save场景自动执行
        if self.email:
            self.email = self.email.strip().lower()
        if self.username:
            self.username = self.username.strip().lower()
    
    def to_json(self):
        return {
            'email': self.email,
            'username': self.username,
            'password': self.password
        }

注意事项 #

• 如果库中已经存在大小写混杂的历史数据，先跑一次性脚本批量把存量数据的email、username转成小写，再删除旧的唯一索引，重启应用让Mongoengine重新创建正确的唯一索引，避免存量重复值导致报错。
• 这个方案对所有写入逻辑生效，不管是注册接口、后台创建用户、批量导入数据，只要调用save()就会自动处理，不会出现漏加.lower()的问题。

方案二：自定义可复用字段（适合多模型场景） #

如果项目里有多个模型都需要大小写不敏感的唯一字段，可以封装通用字段类，一次定义到处用，不用每个模型重复写clean逻辑：

# 可以单独放到fields.py文件中全局复用
class LowerEmailField(db.EmailField):
    def __set__(self, instance, value):
        if isinstance(value, str):
            value = value.strip().lower()
        super().__set__(instance, value)

class LowerStringField(db.StringField):
    def __set__(self, instance, value):
        if isinstance(value, str):
            value = value.strip().lower()
        super().__set__(instance, value)

在模型里直接替换原有字段即可：

class User(db.Document):
    email = LowerEmailField(
        unique = True,
        required = True
    )
    username = LowerStringField(
        unique = True,
        required = True
    )
    password = db.StringField(
        required = True
    )
    # to_json等其余方法保持不变

不建议用MongoDB的区分大小写排序规则（collation）做唯一索引，这种方案需要所有查询、写入操作都显式带上collation配置，维护成本极高，远不如写入层直接归一化简单可靠。

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