当字段为Null时Django unique_together失效，如何实现约束？

针对你遇到的(code, customer)联合唯一约束在customer为NULL时失效的问题，下面提供几种可行的解决方案：

方案一：使用Django的UniqueConstraint（推荐） #

Django 2.2及以上版本支持的UniqueConstraint可以通过条件约束或表达式处理NULL值，完美适配PostgreSQL。

方式1：拆分两个独立的唯一约束 #

分别约束「无客户时的code唯一」和「有客户时的code+customer唯一」：

from django.db import models
from django.db.models import UniqueConstraint, Q

class ProductCode(models.Model):
    customer = models.ForeignKey('customers.Customer', models.CASCADE, null=True, blank=True)
    code = models.CharField(max_length=20)
    product = models.ForeignKey(Product, models.CASCADE)
    
    class Meta:
        # 替换原来的unique_together
        constraints = [
            # 当customer为NULL时，code必须唯一
            UniqueConstraint(
                fields=['code'],
                condition=Q(customer__isnull=True),
                name='unique_code_no_customer'
            ),
            # 当customer不为NULL时，code+customer必须唯一
            UniqueConstraint(
                fields=['code', 'customer'],
                name='unique_code_per_customer'
            )
        ]

方式2：用COALESCE表达式统一处理NULL值 #

利用PostgreSQL的COALESCE函数，将NULL的customer_id替换为一个固定值（比如0），让联合约束对NULL场景生效：

from django.db import models
from django.db.models import UniqueConstraint, Func, Value

class ProductCode(models.Model):
    customer = models.ForeignKey('customers.Customer', models.CASCADE, null=True, blank=True)
    code = models.CharField(max_length=20)
    product = models.ForeignKey(Product, models.CASCADE)
    
    class Meta:
        constraints = [
            UniqueConstraint(
                expressions=[
                    'code',
                    # 将NULL的customer_id转为0，确保联合唯一
                    Func(F('customer'), Value(0), function='COALESCE')
                ],
                name='unique_code_customer'
            )
        ]

方案二：创建占位客户实例 #

创建一个专门的「默认/匿名客户」实例，所有无关联客户的ProductCode都绑定到这个客户。这样customer永远不为NULL，原来的unique_together约束就能正常生效：

1. 在Customer模型中添加一个默认实例（通过数据迁移或后台手动创建）
2. 保存ProductCode时，若customer为NULL，自动关联到这个占位客户

这种方案逻辑简单，不需要修改数据库索引规则，适合对数据库特性不太熟悉的场景。

方案三：拼接前缀到code字段 #

将customer的标识（比如ID）前缀到code字段中，然后给code设置unique=True：

• 当customer存在时，存储格式为{customer_id}:{code}（例如123:foo）
• 当customer不存在时，存储格式为default:{code}（例如default:foo）

查询时：

• 找某客户的特定code：使用code__startswith=f"{customer.id}:"
• 找无客户的特定code：使用code__startswith="default:"

这个方案实现简单，但会增加code字段的长度，且查询需要处理前缀逻辑，适合场景简单的小型项目。

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