如何通过Django信号实现自定义错误校验并在Admin后台友好展示

我懂你的痛点——用pre_save信号抛出异常确实会直接跳调试页面，完全达不到表单内友好提示的效果。其实Django本身就有专门的校验机制，能让错误像必填字段那样显示在对应输入框下方，下面给你两种靠谱的实现方式：

方式一：模型级校验（全局生效） #

给myModel添加clean方法，这是Django推荐的模型级校验，不管是Admin、前端表单还是API调用，只要保存模型都会触发校验，错误会自动关联到对应字段：

from django.core.exceptions import ValidationError
from django.db import models
from django.contrib.postgres.fields import JSONField  # 若使用第三方JSONField请按需替换导入

class myModel(models.Model):
    name = models.CharField(max_length=100)
    type = models.CharField(max_length=100)
    nums = JSONField(null=True, blank=True)

    def clean(self):
        # 先调用父类的clean方法，保证基础校验逻辑生效
        super().clean()
        
        # 如果nums为空，直接跳过校验（根据你的字段允许空的需求调整）
        if self.nums is None or not self.nums:
            return
        
        # 查找同type下的其他记录，排除当前实例本身（避免更新时和自己对比报错）
        same_type_records = myModel.objects.filter(type=self.type).exclude(pk=self.pk)
        
        for record in same_type_records:
            # 跳过对方nums为空的情况
            if not record.nums:
                continue
            
            # 计算两个nums的交集
            common_nums = list(set(record.nums).intersection(self.nums))
            if common_nums:
                # 抛出关联到nums字段的ValidationError，错误会显示在该字段下方
                raise ValidationError({
                    'nums': f"数字 {common_nums} 已在同类型的「{record.name}」中存在，请移除重复项"
                })

方式二：Admin表单级校验（仅Admin生效） #

如果只需要在Django Admin里做这个校验，可以自定义Admin表单，针对nums字段做字段级校验，错误会精准显示在nums输入框下方：

from django.contrib import admin
from django import forms
from .models import myModel

class myModelAdminForm(forms.ModelForm):
    class Meta:
        model = myModel
        fields = '__all__'

    def clean_nums(self):
        # 获取表单中清洗后的nums数据
        nums = self.cleaned_data.get('nums')
        
        # 空值直接返回，不做校验
        if not nums:
            return nums
        
        # 获取当前实例（新增时instance.pk为None，exclude会自动忽略）
        current_instance = self.instance
        # 查找同type的其他记录
        same_type_records = myModel.objects.filter(type=current_instance.type).exclude(pk=current_instance.pk)
        
        for record in same_type_records:
            if record.nums:
                common_nums = list(set(record.nums).intersection(nums))
                if common_nums:
                    raise forms.ValidationError(f"数字 {common_nums} 已在同类型的「{record.name}」中存在，请移除重复项")
        
        return nums

# 注册自定义表单到Admin
@admin.register(myModel)
class myModelAdmin(admin.ModelAdmin):
    form = myModelAdminForm

关键注意点 #

• 排除自身：一定要加上.exclude(pk=self.pk)，不然在更新现有实例时，会和自己的nums对比，导致无意义的报错。
• 空值处理：记得判断nums是否为空，避免None调用set()方法抛出异常。
• 场景选择：模型级校验适合全局生效的场景，Admin表单校验仅针对后台管理界面，按需选择即可。

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