Django模型：能否在UniqueConstraint中使用字典键值？求方案

架构老林

2026-7-17

问题解答

核心结论

Django的UniqueConstraint**不支持直接通过字典键（如name.pt）**来指定约束字段，因为I18nCharField本质是将多语言数据以JSON/JSONB格式存储到数据库，Django ORM的约束系统无法直接解析嵌套的字典键作为约束目标。

实现唯一性校验的合理方案

方案1：新增隐藏字段存储葡萄牙语名称（推荐）

通过新增一个不对外暴露的字段单独存储葡萄牙语名称，直接基于这个字段配置数据库层面的唯一约束，是最可靠的方案。

步骤：

给ScientificArea模型添加name_pt字段，设置editable=False使其不显示在表单中：

class ScientificArea(models.Model):
    # 原有字段...
    name = I18nCharField(
        verbose_name=_("Name"), blank=False, max_length=255
    )
    name_pt = models.CharField(
        verbose_name=_("Portuguese Name"), 
        blank=False, 
        max_length=255, 
        editable=False  # 不在表单显示
    )
    # 其他字段...

重写模型的clean()或save()方法，同步name字段的pt值到name_pt：

def clean(self):
    super().clean()
    # 确保pt值存在（需求中pt为必填项）
    pt_name = self.name.get('pt')
    if not pt_name:
        raise ValidationError({"name": _("Portuguese name is required.")})
    self.name_pt = pt_name.strip()

def save(self, *args, **kwargs):
    self.clean()
    super().save(*args, **kwargs)

更新Meta中的约束，替换原有无效的portuguese_name_uniq约束：

class Meta:
    # 原有配置...
    constraints = [
        # 其他约束...
        models.UniqueConstraint(
            name='portuguese_name_uniq',
            fields=('name_pt',),
        ),
        # 其余约束...
    ]

优点：

数据库层面的唯一约束，彻底避免并发场景下的重复数据问题
查询时可直接用name_pt过滤，性能优于JSONB路径查询
符合Django ORM的常规使用方式，维护成本低
缺点：
存在少量数据冗余，但对于多语言场景来说可接受

方案2：利用PostgreSQL JSONB特性添加原生SQL约束

如果不想新增字段，可以直接利用PostgreSQL对JSONB的支持，手动创建基于name->>'pt'的唯一约束，同时配合模型clean()方法做应用层校验。

步骤：

在模型clean()方法中添加应用层校验：

def clean(self):
    super().clean()
    pt_name = self.name.get('pt')
    if not pt_name:
        raise ValidationError({"name": _("Portuguese name is required.")})
    # 检查是否存在相同pt值的记录
    existing = ScientificArea.objects.filter(
        name__contains={"pt": pt_name.strip()}
    ).exclude(pk=self.pk)
    if existing.exists():
        raise ValidationError({"name": _("This Portuguese name already exists.")})

创建迁移文件后，手动修改迁移文件，添加原生SQL的唯一约束：

from django.db import migrations, models

class Migration(migrations.Migration):
    dependencies = [
        # 依赖的迁移文件...
    ]

    operations = [
        # 原有迁移操作...
        migrations.RunSQL(
            sql="""
            CREATE UNIQUE INDEX portuguese_name_uniq ON app_scientificarea ((name->>'pt'));
            """,
            reverse_sql="""
            DROP INDEX portuguese_name_uniq;
            """
        ),
    ]

优点：

无需新增字段，避免数据冗余
同时具备应用层和数据库层的双重校验
缺点：
依赖PostgreSQL的JSONB特性，跨数据库兼容性差
自定义SQL约束需要手动维护迁移文件，对开发者的SQL能力有要求

方案3：仅在应用层做校验（不推荐）

只在模型的clean()或save()方法中校验葡萄牙语名称的唯一性，这种方案实现简单，但存在并发风险：

def clean(self):
    super().clean()
    pt_name = self.name.get('pt')
    if not pt_name:
        raise ValidationError({"name": _("Portuguese name is required.")})
    pt_name = pt_name.strip()
    existing = ScientificArea.objects.filter(
        name__contains={"pt": pt_name}
    ).exclude(pk=self.pk)
    if existing.exists():
        raise ValidationError({"name": _("This Portuguese name already exists.")})

缺点：

当多个请求同时提交相同的葡萄牙语名称时，可能绕过应用层校验，导致数据库中出现重复数据，因为没有数据库层面的约束做兜底。

对原代码的修正说明

你原有的portuguese_name_uniq约束存在两个问题：

错误使用了designacao字段（应该是name）
条件Q(designacao__contains={"pt": ""})逻辑错误，这是在匹配pt值为空的记录，而非校验pt值的唯一性

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