如何在Django模型中实现预约时段排他性，避免重复预约？

1. 基础Model定义与业务校验 #

先定义包含核心字段的预约Model，同时在Model层实现时段冲突校验，确保保存前检查是否存在重叠预约：

from django.db import models
from django.contrib.auth.models import User
from django.core.exceptions import ValidationError

class Appointment(models.Model):
    user = models.ForeignKey(User, on_delete=models.CASCADE, related_name='appointments')
    start_time = models.DateTimeField(verbose_name="预约开始时间")
    end_time = models.DateTimeField(verbose_name="预约结束时间")

    def clean(self):
        # 基础校验：结束时间必须晚于开始时间
        if self.start_time >= self.end_time:
            raise ValidationError({"end_time": "结束时间必须晚于开始时间"})
        
        # 校验时段是否与已有预约重叠
        # 重叠逻辑：已有预约的开始时间 < 当前预约的结束时间，且已有预约的结束时间 > 当前预约的开始时间
        overlapping_appointments = Appointment.objects.filter(
            start_time__lt=self.end_time,
            end_time__gt=self.start_time
        )
        # 编辑已有预约时，排除自身数据
        if self.pk:
            overlapping_appointments = overlapping_appointments.exclude(pk=self.pk)
        
        if overlapping_appointments.exists():
            raise ValidationError("该时段已有其他用户预约，无法创建/修改")
    
    def save(self, *args, **kwargs):
        # 强制保存前执行完整校验（包含clean方法）
        self.full_clean()
        super().save(*args, **kwargs)

2. 数据库层面兜底约束（解决并发竞态问题） #

仅靠Model层的clean方法无法处理并发场景下的竞态问题（比如两个请求同时通过校验并写入数据库），需要数据库层面的约束作为最后防线。

针对PostgreSQL（推荐）

Django支持PostgreSQL的ExclusionConstraint，直接在Model的Meta类中定义即可：

from django.contrib.postgres.constraints import ExclusionConstraint
from django.contrib.postgres.fields import RangeOperators

# 在Appointment类的Meta中添加约束：
class Meta:
    verbose_name = "预约"
    verbose_name_plural = "预约"
    constraints = [
        ExclusionConstraint(
            name="exclude_overlapping_appointments",
            expressions=(
                # 用时间范围类型校验时段是否重叠
                ("tsrange(start_time, end_time)", RangeOperators.OVERLAPS),
            ),
        )
    ]

添加该约束后，数据库会直接拒绝重叠预约的写入，此时需要在保存时捕获IntegrityError并转换为用户友好的提示：

from django.db import IntegrityError

def save(self, *args, **kwargs):
    try:
        self.full_clean()
        super().save(*args, **kwargs)
    except IntegrityError:
        raise ValidationError("该时段已有其他用户预约，无法创建/修改")

针对MySQL

由于MySQL不支持ExclusionConstraint，可以通过以下方式兜底：

• 编写数据库触发器，在插入/更新时检查时段重叠
• 在视图层开启事务，先锁定Appointment表再执行校验与保存（性能略差，但可解决并发问题）

补充说明 #

• Django表单提交时会自动调用clean方法，但如果是后台代码直接创建/修改预约，必须确保调用full_clean()或在save方法中自动触发校验。
• 数据库约束是最后一道防线，避免并发场景下的冲突漏检。

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