Django表单校验：如何实现项目内Descriptor名称唯一？

看起来你是想实现同一Project下Descriptor名称唯一的校验，但因为错误地引用了表单字段对象而非用户选择的实际值，导致了TypeError。我来一步步帮你解决这个问题：

错误原因分析 #

你遇到的TypeError: int() argument must be a string, a bytes-like object or a number, not 'ModelChoiceField'，大概率是因为在表单的clean方法中，直接使用了self.fields['project']来获取项目——这拿到的是ModelChoiceField这个字段对象，而不是用户实际选择的Project实例/ID，所以在ORM查询时会报错。

修正后的表单实现 #

假设你的模型结构大概是这样（和你提供的代码对应）：

# models.py
from django.db import models

class Project(models.Model):
    name = models.CharField(max_length=100)
    # 其他自定义字段...

class Descriptor(models.Model):
    project = models.ForeignKey(Project, on_delete=models.CASCADE)
    name = models.CharField(max_length=100)
    # 其他自定义字段...

修改表单的clean方法，正确获取用户选择的Project，并实现当前Project内名称唯一的校验，同时兼容编辑场景（排除当前实例）：

# forms.py
from django import forms
from .models import Descriptor

class DescriptorForm(forms.ModelForm):
    class Meta:
        model = Descriptor
        fields = ['project', 'name']  # 加上你的其他字段

    def clean(self):
        cleaned_data = super().clean()
        # 从cleaned_data中获取用户提交的实际值，而不是字段对象
        project = cleaned_data.get('project')
        name = cleaned_data.get('name')

        # 先确保两个字段都通过了基础校验（避免其中一个为None的情况）
        if project and name:
            # 构建查询：当前Project下同名的Descriptor
            queryset = Descriptor.objects.filter(project=project, name=name)
            
            # 如果是编辑已有实例，排除当前实例本身，避免自己和自己冲突
            if self.instance.pk:
                queryset = queryset.exclude(pk=self.instance.pk)
            
            # 检查是否存在重复
            if queryset.exists():
                # 把错误绑定到name字段，用户体验更友好
                self.add_error('name', '该名称在当前项目下已存在，请更换')
        
        return cleaned_data

可选增强：数据库层面的唯一性保障 #

为了避免并发场景下的竞态问题（比如两个请求同时提交相同名称的Descriptor），建议在模型层添加联合唯一约束：

# models.py - Descriptor模型中添加Meta类
class Descriptor(models.Model):
    project = models.ForeignKey(Project, on_delete=models.CASCADE)
    name = models.CharField(max_length=100)
    # 其他字段...

    class Meta:
        # 确保project和name的组合在数据库中唯一
        unique_together = ('project', 'name')

这样即使表单校验没拦住，数据库也会抛出IntegrityError，你可以在视图中捕获这个错误并返回友好提示。

为什么原来的全局校验会生效？ #

当你移除Project相关的校验逻辑时，filter(name=name)会查询所有Descriptor，自然是全局唯一的——而我们通过添加project=project的过滤条件，就把校验范围缩小到了当前选中的Project内。

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