Django：后台修改表单不显示ValidationError报错信息

这个问题我之前也遇到过，Django Admin对模型clean方法抛出的错误处理有时候确实有点 tricky，尤其是当错误没有明确关联到表单字段的时候。咱们一步步来解决：

首先，先把你的clean方法补全并优化——目前的代码看起来没写完，而且要注意排除当前实例（不然编辑已存在的Profile时会误触发验证）：

from django.core.exceptions import ValidationError
from django.db import models
from django.contrib.auth.models import User

class Profile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    organisation = models.ForeignKey(Organisation, on_delete=models.CASCADE)

    def clean(self):
        super().clean()  # 必须调用父类的clean方法，确保基础验证执行
        # 只有当organisation和user都存在时才触发邮箱唯一性验证
        if self.organisation and self.user:
            # 排除当前实例，避免编辑自身时触发重复验证
            duplicate = Profile.objects.filter(
                user__email=self.user.email,
                organisation=self.organisation
            ).exclude(pk=self.pk)
            
            if duplicate.exists():
                # 把错误关联到user字段，这样Admin会在对应的输入框旁显示错误提示
                raise ValidationError({
                    'user': f"邮箱 {self.user.email} 已在该组织中注册"
                })

为什么Admin里不显示错误？ #

默认情况下，Django Admin会调用模型的clean方法，但如果你的错误是非字段错误（没有关联到具体字段的ValidationError），Admin只会在表单顶部显示一个不起眼的提示，很容易被忽略。上面的代码把错误关联到user字段，就能让错误直接显示在对应的输入框旁边，更直观。

如果还是不显示？试试自定义Admin表单 #

有时候，Admin表单可能没有正确同步User的最新邮箱（比如你在Profile表单里直接修改User的邮箱字段），这时候在模型的clean方法里拿到的可能是数据库里的旧值，导致验证失效。这种情况下，用自定义Admin表单来处理验证更可靠：

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

class ProfileAdminForm(forms.ModelForm):
    class Meta:
        model = Profile
        fields = '__all__'

    def clean(self):
        cleaned_data = super().clean()
        user = cleaned_data.get('user')
        organisation = cleaned_data.get('organisation')
        
        # 确保user和organisation都被正确提交
        if not user or not organisation:
            return cleaned_data
            
        # 获取表单中最新的邮箱值（如果允许在Profile表单中修改User邮箱）
        email = user.email
        
        # 同样排除当前实例，避免编辑自身时误判
        duplicate = Profile.objects.filter(
            user__email=email,
            organisation=organisation
        ).exclude(pk=self.instance.pk)
        
        if duplicate.exists():
            # 抛出关联到user字段的错误
            raise forms.ValidationError({
                'user': f"邮箱 {email} 已在该组织中存在"
            })
        return cleaned_data

class ProfileAdmin(admin.ModelAdmin):
    form = ProfileAdminForm
    # 可添加其他Admin配置，比如列表展示字段
    # list_display = ('user', 'organisation')

admin.site.register(Profile, ProfileAdmin)

额外检查点 #

• 确保你的Admin类没有覆盖save_model或clean方法而忘记调用super()，否则模型的验证逻辑不会被执行。
• 如果是通过User Admin的Inline来编辑Profile，那需要把验证逻辑加到User的Admin表单里，或者在Inline表单中添加对应验证。
• 测试时要覆盖两种场景：创建新Profile时输入重复邮箱，编辑现有Profile时修改邮箱为组织内已存在的地址。

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