Django中如何基于Customer字段实现lat与long的联合唯一约束？

现有Django模型代码如下：

class Address(models.Model):
    customer = models.ForeignKey(Customer, related_name='addresses',
                                 on_delete=models.CASCADE)
    lat = models.FloatField()
    long = models.FloatField()
    ...

    class Meta:
        constraints = [
            UniqueConstraint(fields=['lat', 'long'], name='lat_long_unique')
        ]

需求是让lat和long字段仅在同一Customer下保持联合唯一：不同Customer可以拥有相同的lat/long组合，但同一Customer不能重复。

尝试过将约束字段改为['customer', 'lat', 'long']但未生效，使用unique_together的几种写法也没达到预期，同时遇到约束生效时抛出IntegrityError而非表单友好提示的问题。

正确实现方式 #

1. 修正UniqueConstraint约束 #

直接在UniqueConstraint的fields中包含customer、lat、long三个字段（这是Django 2.2+推荐的方式，unique_together已被标记为过时）：

class Address(models.Model):
    customer = models.ForeignKey(Customer, related_name='addresses',
                                 on_delete=models.CASCADE)
    lat = models.FloatField()
    long = models.FloatField()
    ...

    class Meta:
        constraints = [
            UniqueConstraint(
                fields=['customer', 'lat', 'long'],
                name='customer_lat_long_unique'
            )
        ]

2. 执行数据库迁移 #

修改模型后必须执行迁移命令，确保约束同步到数据库：

python manage.py makemigrations
python manage.py migrate

为什么之前的尝试无效？ #

• 若修改约束后未执行迁移，数据库层面的旧约束仍在，新约束未生效，导致看起来没效果。
• unique_together(('customer', 'lat',), ('customer','long',))是定义两组独立的联合唯一（customer+lat、customer+long），并非三者的联合唯一，所以同一Customer下重复lat/long仍能插入。
• 直接用unique_together('customer', 'lat', 'long')本身逻辑正确，但如果未迁移或未清理旧约束，也会导致异常。

处理表单友好提示（避免IntegrityError） #

当数据库约束生效时，直接提交重复数据会抛出IntegrityError服务器错误，要让表单返回自定义中文提示，需在表单类中添加验证逻辑：

from django import forms
from .models import Address

class AddressForm(forms.ModelForm):
    class Meta:
        model = Address
        fields = ['customer', 'lat', 'long']

    def clean(self):
        cleaned_data = super().clean()
        customer = cleaned_data.get('customer')
        lat = cleaned_data.get('lat')
        long = cleaned_data.get('long')

        if customer and lat and long:
            # 检查同一客户下是否存在重复坐标
            exists = Address.objects.filter(
                customer=customer,
                lat=lat,
                long=long
            ).exists()
            if exists:
                raise forms.ValidationError('该客户已存在此地址坐标，请更换。')
        return cleaned_data

这样提交重复数据时，模板中的{{form.non_field_errors}}会返回自定义的中文提示，而非服务器错误页面。

内容的提问来源于stack exchange，提问作者Andi Fathul Mukminin