Django模型primary_key与UniqueConstraint复合主键相关疑问

你给出的场景对应的模型代码如下（已修正原代码的写法错误：UniqueConstraint必须放在内部Meta类的constraints列表中才能生效，直接写在类顶层不会被Django识别）：

class MyClass (models.Model):
    field1 = models.IntegerField(primary_key=True)
    field2 = models.IntegerField()
    
    class Meta:
        constraints = [
            models.UniqueConstraint(fields=['field1', 'field2'], name='ConstraintName')
        ]

插入测试结论 #

你无法同时插入(1,1)和(1,2)这两组数据：

• 插入第一组数据(field1=1, field2=1)时可以正常写入，此时主键约束和联合唯一约束都满足要求。
• 插入第二组数据(field1=1, field2=2)时会直接触发数据库级别的主键冲突，抛出IntegrityError，根本不会走到自定义联合约束的校验逻辑——数据库对约束的校验有优先级，主键约束的检查早于普通唯一约束，只要field1的值重复就会被直接拦截。

Django中primary_key=True的实际语义 #

只要在模型字段上指定primary_key=True，Django会自动为该字段追加隐式约束，替代框架默认生成的自增id主键，核心特性如下：

• 自带非空约束：该字段不允许存入NULL值，不需要额外配置null=False
• 自带单字段全局唯一约束：整张表中这个字段的值不能出现重复，这是数据库层面主键的强制要求
• 一个模型有且仅有一个主键：不管是默认生成的自增id字段、手动指定的单字段主键，还是多字段复合主键，一张数据库表仅能存在一个主键约束

为什么该写法和复合主键效果不等价 #

你当前定义的联合唯一约束本身是完全冗余的：
因为field1作为单字段主键已经要求全局唯一，任意两行的field1值必然不同，那么(field1, field2)的组合自然也不可能重复，这个自定义约束永远不会触发冲突场景，没有实际作用。

真正的复合主键是将多个字段共同作为主键，此时单个字段没有全局唯一要求，只要多字段的组合值不重复即可。比如如果(field1, field2)是复合主键，(1,1)和(1,2)是可以正常同时插入的，但你当前的写法本质是单字段主键加冗余联合唯一约束，完全达不到复合主键的效果。

补充说明：Django原生目前对复合主键的支持仍有局限，如果你需要实现“单个字段可重复、多字段组合唯一”的效果，不要给单个字段加primary_key=True，保留默认的自增id主键，再通过Meta.constraints添加联合唯一约束即可满足需求。

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