如何确保Django模型同一组合下仅一条记录布尔字段为True

这个约束无法仅靠基础的unique_together配置实现，但可以通过Django内置的条件约束+少量自定义校验逻辑组合实现，不需要额外引入第三方包。

1. 数据库层兜底约束（Django原生内置能力） #

Django 2.2及以上版本原生支持带条件的唯一约束，可以直接在模型Meta类中配置，生成数据库级的部分唯一索引，从底层阻断脏数据写入：

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

class ProjectMembership(models.Model):
    guard = models.ForeignKey(Guard, on_delete=models.CASCADE)
    project = models.ForeignKey(Project, on_delete=models.CASCADE)
    is_main = models.BooleanField(_('is main project'), default=False)

    class Meta:
        unique_together = ['guard', 'project']
        constraints = [
            UniqueConstraint(
                fields=['guard'],
                condition=Q(is_main=True),
                name='unique_main_project_per_guard'
            )
        ]

该约束的作用：仅对is_main=True的记录做guard维度的唯一性校验，同一个Guard下如果出现两条is_main=True的关联记录，数据库会直接抛出完整性错误，不受ORM操作方式限制，是数据一致性的核心兜底。

2. 应用层校验逻辑（优化体验+适配业务流程） #

数据库层的约束只会抛出底层异常，对终端用户不友好，且在更新记录时如果操作顺序不当容易触发报错，需要补充少量应用层逻辑：

• 方案A：严格校验，重复时抛出明确提示
  重写模型的clean()方法，在数据校验阶段就拦截非法输入：

from django.core.exceptions import ValidationError

def clean(self):
    if self.is_main:
        has_other_main = ProjectMembership.objects.filter(
            guard=self.guard,
            is_main=True
        ).exclude(pk=self.pk).exists()
        if has_other_main:
            raise ValidationError(
                {'is_main': '同一个Guard仅允许设置一个主项目归属'}
            )

• 方案B：自动处理，无需用户手动修改旧记录
  如果业务允许设置新主归属时自动取消旧的主归属标记，可以重写save()方法实现自动更新，注意要放在事务中保证原子性：

from django.db import transaction

def save(self, *args, **kwargs):
    with transaction.atomic():
        if self.is_main:
            # 将同Guard下其他主归属记录全部设为False
            ProjectMembership.objects.filter(
                guard=self.guard,
                is_main=True
            ).exclude(pk=self.pk).update(is_main=False)
        super().save(*args, **kwargs)

• 不要省略数据库层的条件约束：如果存在批量update、原生SQL写入、多进程并发操作的场景，仅靠应用层的save/clean逻辑无法完全避免脏数据，数据库约束是最后一道防线。该约束生成的是部分唯一索引，目前MySQL 5.7+、PostgreSQL、SQLite均兼容该语法。
• 如果使用DRF、自定义表单等非Django Admin入口，需要在序列化器校验、表单校验逻辑中同步调用模型的clean()方法，或者补充对应的校验规则，避免校验逻辑不生效。

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