Django模型：如何实现设备名仅在所属用户范围内唯一

嘿，这个需求在Django里处理起来很清晰，核心就是给设备名加上用户维度的联合唯一约束——让user和name这两个字段组合起来唯一，这样不同用户可以用相同的设备名，但同一用户下绝对不会重复。我给你两种实现方式，看你的Django版本来选：

方法一：Django 2.2+ 推荐使用 UniqueConstraint（更灵活） #

从Django 2.2开始，官方推荐用UniqueConstraint来定义联合唯一约束，它比旧的unique_together更灵活，还支持添加条件约束等高级用法。

直接在Device模型的Meta类里定义约束即可：

from django.db import models
from django.contrib.auth.models import User

class Device(models.Model):
    user = models.ForeignKey(User, on_delete=models.CASCADE, related_name="devices")
    name = models.CharField(max_length=100)  # 用户自定义的设备名
    mac_address = models.CharField(max_length=17, unique=True)  # 全局唯一的MAC地址

    class Meta:
        # 定义联合唯一约束：同一用户下的设备名不能重复
        constraints = [
            models.UniqueConstraint(
                fields=['user', 'name'], 
                name='unique_user_device_name'  # 约束名，数据库里会用到
            )
        ]

这个约束会在数据库层面创建联合唯一索引，彻底避免同一用户重复创建同名设备的问题——哪怕并发请求过来，数据库也会直接拦截，保证数据一致性。

方法二：旧版本Django（<2.2）用 unique_together #

如果你的项目还在使用Django 2.2之前的版本，就用unique_together来实现，它是旧版的标准写法：

from django.db import models
from django.contrib.auth.models import User

class Device(models.Model):
    user = models.ForeignKey(User, on_delete=models.CASCADE, related_name="devices")
    name = models.CharField(max_length=100)
    mac_address = models.CharField(max_length=17, unique=True)

    class Meta:
        # 旧版本写法，新版本已标记为过时（deprecated）
        unique_together = ('user', 'name')

额外提示：表单层面提前做验证 #

虽然数据库约束是最后一道防线，但为了给用户更友好的提示，建议在表单里提前验证。比如重写表单的clean_name方法：

from django import forms
from .models import Device

class DeviceForm(forms.ModelForm):
    def __init__(self, *args, **kwargs):
        self.user = kwargs.pop('user')  # 从视图传递当前用户
        super().__init__(*args, **kwargs)

    class Meta:
        model = Device
        fields = ['name', 'mac_address']

    def clean_name(self):
        name = self.cleaned_data.get('name')
        # 检查当前用户下是否已有同名设备
        if Device.objects.filter(user=self.user, name=name).exists():
            raise forms.ValidationError("你已经使用过这个设备名啦，请换一个试试～")
        return name

然后在视图里初始化表单时，把当前用户传进去：

def add_device(request):
    if request.method == 'POST':
        form = DeviceForm(request.POST, user=request.user)
        if form.is_valid():
            device = form.save(commit=False)
            device.user = request.user
            device.save()
            # 跳转或提示成功
    else:
        form = DeviceForm(user=request.user)
    # 渲染模板

这样用户在输入重复名称时，就能立刻收到提示，不用等到数据库报错再处理啦～

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