如何实现多模型间index字段唯一及Admin页面无刷新验证？

之前我也碰到过类似的问题——在save方法里抛ValidationError确实容易导致500错误，尤其是关闭Debug模式后用户完全看不到有效提示。要在Admin页面实现无刷新的验证提示，核心思路是把验证逻辑从save方法移到表单的clean阶段，因为Django Admin会自动处理表单验证抛出的异常，并在页面内友好展示错误信息，不会跳转到错误页面。

下面是具体的实现步骤：

1. 自定义ModelForm，实现跨模型唯一性验证 #

我们需要为每个涉及的模型创建自定义的ModelForm，在表单的clean_index方法中检查所有相关模型的index是否重复，同时要注意排除当前编辑的实例（避免编辑时误判为重复）。

假设你的三个模型是ModelA、ModelB、ModelC，都包含index（正小整数）字段，代码示例如下：

from django import forms
from django.core.exceptions import ValidationError
from .models import ModelA, ModelB, ModelC

# 定义基类表单，抽离通用验证逻辑
class BaseIndexModelForm(forms.ModelForm):
    def clean_index(self):
        current_index = self.cleaned_data.get('index')
        # 检查所有模型中是否存在该index
        has_duplicate = (
            ModelA.objects.filter(index=current_index).exists() or
            ModelB.objects.filter(index=current_index).exists() or
            ModelC.objects.filter(index=current_index).exists()
        )

        # 如果是编辑现有实例，需要排除自身的index
        if self.instance.pk:
            if isinstance(self.instance, ModelA):
                has_duplicate = (
                    ModelA.objects.filter(index=current_index).exclude(pk=self.instance.pk).exists() or
                    ModelB.objects.filter(index=current_index).exists() or
                    ModelC.objects.filter(index=current_index).exists()
                )
            elif isinstance(self.instance, ModelB):
                has_duplicate = (
                    ModelA.objects.filter(index=current_index).exists() or
                    ModelB.objects.filter(index=current_index).exclude(pk=self.instance.pk).exists() or
                    ModelC.objects.filter(index=current_index).exists()
                )
            elif isinstance(self.instance, ModelC):
                has_duplicate = (
                    ModelA.objects.filter(index=current_index).exists() or
                    ModelB.objects.filter(index=current_index).exists() or
                    ModelC.objects.filter(index=current_index).exclude(pk=self.instance.pk).exists()
                )

        if has_duplicate:
            raise ValidationError(f"索引 {current_index} 已在其他模型中使用，请选择一个不同的数值。")
        return current_index

# 为每个模型创建对应的表单
class ModelAForm(BaseIndexModelForm):
    class Meta:
        model = ModelA
        fields = '__all__'

class ModelBForm(BaseIndexModelForm):
    class Meta:
        model = ModelB
        fields = '__all__'

class ModelCForm(BaseIndexModelForm):
    class Meta:
        model = ModelC
        fields = '__all__'

2. 在Admin中注册自定义表单 #

接下来，修改你的admin.py，让每个模型的Admin类使用我们刚才定义的表单：

from django.contrib import admin
from .models import ModelA, ModelB, ModelC
from .forms import ModelAForm, ModelBForm, ModelCForm

@admin.register(ModelA)
class ModelAAdmin(admin.ModelAdmin):
    form = ModelAForm  # 指定自定义表单

@admin.register(ModelB)
class ModelBAdmin(admin.ModelAdmin):
    form = ModelBForm

@admin.register(ModelC)
class ModelCAdmin(admin.ModelAdmin):
    form = ModelCForm

这样设置后，当你在Admin页面提交表单时，如果index重复，系统会在index字段下方直接显示错误提示，不会跳转到500页面，完全符合你要的无刷新提示效果。

3. 可选：添加数据库层面的约束（兜底防并发） #

上面的表单验证能覆盖绝大多数场景，但如果遇到高并发情况（比如两个用户同时提交相同的index），可能会出现表单验证都通过，但数据库写入时出现重复的情况。为了彻底避免这种问题，可以添加数据库层面的约束：

我们可以创建一个单独的GlobalIndex表，专门存储所有唯一的index值，然后让三个模型通过一对一关联这个表：

from django.db import models

class GlobalIndex(models.Model):
    index = models.PositiveSmallIntegerField(unique=True, verbose_name="全局唯一索引")

    def __str__(self):
        return str(self.index)

# 修改原有模型
class ModelA(models.Model):
    index = models.OneToOneField(GlobalIndex, on_delete=models.CASCADE, verbose_name="索引")
    # 其他字段...

class ModelB(models.Model):
    index = models.OneToOneField(GlobalIndex, on_delete=models.CASCADE, verbose_name="索引")
    # 其他字段...

class ModelC(models.Model):
    index = models.OneToOneField(GlobalIndex, on_delete=models.CASCADE, verbose_name="索引")
    # 其他字段...

然后修改之前的BaseIndexModelForm，让用户可以直接输入index数值，自动关联或创建GlobalIndex实例：

class BaseIndexModelForm(forms.ModelForm):
    # 自定义输入字段，替代原来的外键选择框
    index_value = forms.PositiveSmallIntegerField(label="索引")

    def clean_index_value(self):
        index_val = self.cleaned_data.get('index_value')
        # 检查全局索引是否已存在
        has_duplicate = GlobalIndex.objects.filter(index=index_val).exists()
        # 编辑时排除当前实例关联的索引
        if self.instance.pk:
            has_duplicate = GlobalIndex.objects.filter(index=index_val).exclude(pk=self.instance.index.pk).exists()
        if has_duplicate:
            raise ValidationError(f"索引 {index_val} 已被使用，请选择其他数值。")
        return index_val

    def save(self, commit=True):
        instance = super().save(commit=False)
        index_val = self.cleaned_data.get('index_value')
        # 获取或创建全局索引实例
        global_index, _ = GlobalIndex.objects.get_or_create(index=index_val)
        instance.index = global_index
        if commit:
            instance.save()
        return instance

    class Meta:
        exclude = ['index']  # 排除原有的外键字段

这样既保留了Admin页面的友好输入体验，又通过数据库的unique约束彻底保证了index的全局唯一性。

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