如何在Django模型中实现用户单俱乐部唯一会员资格限制？

要实现每位用户在单个体育中心仅能拥有一个会员资格，核心是给user和club字段添加联合唯一约束，确保这两个字段的组合在数据库中唯一。下面提供两种实现方式，推荐使用第二种（Django官方推荐的现代写法）：

方法1：使用unique_together（兼容旧版本Django） #

这是Django早期的写法，在模型的Meta类中定义联合唯一约束：

class Membership(models.Model):
    user = models.ForeignKey(User, on_delete=models.CASCADE, related_name='memberships')
    club = models.ForeignKey(Club, on_delete=models.CASCADE, related_name='memberships')
    points = models.PositiveIntegerField(default=0, blank=True, null=True)
    sub_date = models.DateField(auto_now_add=True)

    class Meta:
        # 确保user和club的组合唯一
        unique_together = ('user', 'club')

方法2：使用UniqueConstraint（Django 2.2+ 推荐） #

这种写法更灵活，支持添加约束名称、条件约束等扩展功能，是Django官方推荐的现代方案：

class Membership(models.Model):
    user = models.ForeignKey(User, on_delete=models.CASCADE, related_name='memberships')
    club = models.ForeignKey(Club, on_delete=models.CASCADE, related_name='memberships')
    points = models.PositiveIntegerField(default=0, blank=True, null=True)
    sub_date = models.DateField(auto_now_add=True)

    class Meta:
        constraints = [
            models.UniqueConstraint(
                fields=['user', 'club'],
                name='unique_user_club_membership'
            )
        ]

后续操作 #

添加约束后，需要生成并执行数据库迁移，让约束生效：

1. 运行迁移生成命令：python manage.py makemigrations
2. 执行迁移：python manage.py migrate

这样修改后，当用户尝试为同一俱乐部创建第二个会员记录时，Django会抛出IntegrityError，数据库层面也会阻止重复数据的插入，从根本上保证了数据的唯一性。

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