Django对接PostgreSQL时如何对含NULL值的字段强制联合唯一性约束

针对PostgreSQL下唯一约束不识别NULL相等的问题，你可以根据业务场景选择以下几种实现方式：

方案1：调整字段定义（最推荐，符合Django最佳实践） #

Django官方不推荐对CharField设置null=True，字符串类型的空值统一用空字符串''表示即可，完全可以避免NULL带来的唯一约束失效问题：

1. 修正字段定义，显式指定null=False（CharField默认值就是False，显式写可以避免后续误改）：

class MyModel(models.Model):
    name = models.CharField('Name', max_length=255, null=False)
    # 不设置null=True，空白输入会自动存储为空字符串''
    title = models.CharField('Title', max_length=255, blank=True, null=False)
    position = models.CharField('Position', max_length=255, blank=True, null=False)

2. 保留你原来的UniqueConstraint即可，空字符串会被PostgreSQL识别为相等值，重复组合会直接触发约束报错。

方案2：使用空值安全的表达式约束（适合必须区分NULL和空字符串的场景） #

如果你的业务逻辑需要明确区分NULL和空字符串''，可以用Django 3.2+支持的表达式唯一约束，通过COALESCE函数把NULL转换为业务中不可能出现的占位符后再做唯一性校验：

from django.db import models
from django.db.models import Value
from django.db.models.functions import Coalesce

class MyModel(models.Model):
    name = models.CharField('Name', max_length=255, null=False)
    title = models.CharField('Title', max_length=255, blank=True, null=True)
    position = models.CharField('Position', max_length=255, blank=True, null=True)

    class Meta:
        constraints = [
            models.UniqueConstraint(
                expressions=[
                    Coalesce('name', Value('___NULL_PLACEHOLDER___')),
                    Coalesce('title', Value('___NULL_PLACEHOLDER___')),
                    Coalesce('position', Value('___NULL_PLACEHOLDER___')),
                ],
                name="unique_name_title_position"
            )
        ]

注意：你需要保证___NULL_PLACEHOLDER___是业务中永远不会出现的字符串，避免误判重复。

方案3：应用层校验补充（适合低并发场景/旧版本Django） #

你可以重写模型的clean方法在应用层做重复校验，适合作为数据库约束的补充，不要单独使用（高并发下会有竞态问题）：

from django.core.exceptions import ValidationError
from django.db.models import Q

class MyModel(models.Model):
    # 字段定义省略
    def clean(self):
        # 排除自身查询是否存在重复组合
        duplicate = MyModel.objects.filter(
            Q(name=self.name) &
            Q(title=self.title) &
            Q(position=self.position)
        ).exclude(pk=self.pk).exists()
        if duplicate:
            raise ValidationError("name、title、position的组合已存在")
    
    def save(self, *args, **kwargs):
        # 手动触发校验，表单/DRF序列化器场景会自动调用clean无需额外处理
        self.full_clean()
        super().save(*args, **kwargs)

迁移注意事项 #

如果你的数据库中已经存在title或position为NULL的旧数据，需要先执行数据迁移把NULL值转换为对应的空字符串或者占位符之后，再更新约束，否则迁移会执行失败。

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