Django中使用update_or_create时如何实现字段预处理约束？

针对你遇到的问题，核心矛盾是既要在存储前格式化字段，又要保证查询匹配时用格式化后的值，以下是几种实用的解决方案：

1. 自定义字段（推荐） #

这是最彻底的方式，让字段本身自动处理格式化逻辑，不管是创建、更新还是查询，都会统一处理，从根源避免重复数据。

自定义一个首字母大写的CharField：

from django.db import models

class ProperCaseCharField(models.CharField):
    def to_python(self, value):
        # 先调用父类的to_python做基础数据处理
        value = super().to_python(value)
        # 对字符串执行首字母大写格式化
        if isinstance(value, str):
            return value.title()
        return value

然后在模型中替换原有的CharField：

class Person(models.Model):
    first_name = ProperCaseCharField(max_length=100)
    last_name = ProperCaseCharField(max_length=100)

这样一来，不管你传入的是"john"还是"John"，都会被自动转为"John"存储；调用update_or_create时，传入的参数会先经过字段的to_python处理，用格式化后的值去匹配数据库，不会因为大小写问题创建重复对象。

2. 数据库层面加唯一约束（可选） #

为了防止直接通过SQL或其他绕过模型层的操作插入未格式化的数据，可以在模型中添加唯一约束，确保姓名组合唯一：

class Person(models.Model):
    first_name = ProperCaseCharField(max_length=100)
    last_name = ProperCaseCharField(max_length=100)

    class Meta:
        constraints = [
            models.UniqueConstraint(fields=['first_name', 'last_name'], name='unique_full_name')
        ]

这样即使有漏网之鱼，数据库也会抛出唯一性错误，避免重复数据入库。

为什么不推荐重写save/clean？ #

• 重写save方法：update_or_create的逻辑是先执行查询匹配（用原始传入的参数），再调用save方法。如果传入的是小写值，查询阶段找不到匹配对象，就会创建新条目，save时的格式化已经晚了，还是会产生重复。
• 重写clean方法：Django Ninja默认不会自动调用模型的clean方法，需要在API逻辑中手动调用，不仅增加代码复杂度，还容易因为遗漏调用导致未格式化的数据入库。

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