Django模型约束问题：同一SimCard与start_date下各计费字段仅存唯一值

你遇到的核心问题是原UniqueConstraint约束因NULL值的数据库处理逻辑失效：数据库中NULL不等于任何值（包括另一个NULL），所以当两条记录的simcard和start_date相同、且对应计费字段（如duration_billed）均为NULL时，数据库会认为这两条记录不重复，从而允许插入。

以下是两种针对性的解决方案：

方案一：重构模型设计（推荐） #

这种方式更符合数据库设计范式，从根源上避免NULL值带来的约束问题。将三个计费字段合并为「计费类型」+「计费值」的结构，通过唯一约束保证同一simcard+start_date下每种计费类型仅存一条记录。

from django.db import models

class Consumption(models.Model):
    # 定义计费类型选项
    BILLING_TYPE_CHOICES = [
        ('duration', '时长计费'),
        ('volume', '流量计费'),
        ('sms', '短信计费'),
    ]
    
    simcard = models.ForeignKey(SimCard, on_delete=models.CASCADE)
    start_date = models.DateTimeField()
    billing_type = models.CharField(max_length=20, choices=BILLING_TYPE_CHOICES)
    billed_value = models.FloatField()  # 存储对应类型的计费值

    class Meta:
        constraints = [
            UniqueConstraint(
                fields=['simcard', 'start_date', 'billing_type'],
                name='unique_simcard_startdate_billingtype'
            )
        ]

方案二：保留原模型，添加条件约束与验证 #

如果必须保留原模型结构，需要通过条件约束（针对非NULL字段）+模型验证方法来实现需求：

from django.db import models
from django.core.exceptions import ValidationError

class Consumption(models.Model):
    simcard = models.ForeignKey(SimCard, on_delete=models.CASCADE)
    start_date = models.DateTimeField()
    duration_billed = models.FloatField(null=True)
    volume_billed = models.FloatField(null=True)
    sms_billed = models.FloatField(null=True)

    def clean(self):
        """保存前验证，避免数据库约束覆盖不到的场景"""
        super().clean()
        
        # 检查同一simcard+start_date下是否已有非NULL的时长计费记录
        if self.duration_billed is not None:
            exists = Consumption.objects.filter(
                simcard=self.simcard,
                start_date=self.start_date,
                duration_billed__isnull=False
            ).exclude(pk=self.pk).exists()
            if exists:
                raise ValidationError("同一SIM卡和起始日期下，时长计费记录已存在")
        
        # 检查流量计费记录
        if self.volume_billed is not None:
            exists = Consumption.objects.filter(
                simcard=self.simcard,
                start_date=self.start_date,
                volume_billed__isnull=False
            ).exclude(pk=self.pk).exists()
            if exists:
                raise ValidationError("同一SIM卡和起始日期下，流量计费记录已存在")
        
        # 检查短信计费记录
        if self.sms_billed is not None:
            exists = Consumption.objects.filter(
                simcard=self.simcard,
                start_date=self.start_date,
                sms_billed__isnull=False
            ).exclude(pk=self.pk).exists()
            if exists:
                raise ValidationError("同一SIM卡和起始日期下，短信计费记录已存在")

    class Meta:
        constraints = [
            # 当duration_billed非NULL时，simcard+start_date必须唯一
            UniqueConstraint(
                fields=['simcard', 'start_date'],
                condition=models.Q(duration_billed__isnull=False),
                name='unique_simcard_startdate_duration'
            ),
            # 流量计费的条件约束
            UniqueConstraint(
                fields=['simcard', 'start_date'],
                condition=models.Q(volume_billed__isnull=False),
                name='unique_simcard_startdate_volume'
            ),
            # 短信计费的条件约束
            UniqueConstraint(
                fields=['simcard', 'start_date'],
                condition=models.Q(sms_billed__isnull=False),
                name='unique_simcard_startdate_sms'
            )
        ]

注意事项 #

修改模型后必须生成并应用迁移，才能让数据库约束生效：

python manage.py makemigrations
python manage.py migrate

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