Django如何配置自定义字段验证器仅在字段变更时执行？

你的核心问题是Django默认会在每次保存模型时触发所有字段的验证器，包括父模型保存时内联子模型的无意义重复验证。下面提供两种实用的解决思路：

方法一：重写模型的clean方法（全局生效） #

直接在GalleryImage模型中控制验证时机，只有当图片字段新增或修改时才执行尺寸检查。同时注意修复验证器的方法名（必须是__call__而非call，否则Django无法识别）。

修改后的models.py代码：

from django.db import models
from django.core.exceptions import ValidationError
from django.utils.deconstruct import deconstructible

@deconstructible 
class ImageValidator(object): 
    """检查图片尺寸是否符合要求""" 
    def __call__(self, value):
        # 这里写你的尺寸检查逻辑
        # 示例：模拟判断图片过大
        too_big = False  # 替换为实际检查代码
        if too_big: 
            raise ValidationError('图片尺寸过大')

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

class GalleryImage(models.Model):
    profile = models.ForeignKey(Profile, on_delete=models.CASCADE)
    image = models.ImageField()  # 这里不再直接绑定validators

    def clean(self):
        super().clean()
        # 仅在新建实例，或image字段有变更时执行验证
        if self.pk is None or 'image' in self._changed_fields:
            validator = ImageValidator()
            validator(self.image)

方法二：重写内联表单的clean方法（仅Admin生效） #

如果只需要在Admin内联场景下优化，可通过重写内联表单的字段验证逻辑，利用表单的changed_data属性判断字段是否被修改。

修改后的admin.py代码：

from django.contrib import admin
from django import forms
from .models import Profile, GalleryImage, ImageValidator

class GalleryImageForm(forms.ModelForm):
    class Meta:
        model = GalleryImage
        fields = '__all__'
    
    def clean_image(self):
        image = self.cleaned_data.get('image')
        # 仅在新增实例，或image字段在本次提交中被修改时执行验证
        if self.instance.pk is None or 'image' in self.changed_data:
            validator = ImageValidator()
            validator(image)
        return image

class GalleryImageInline(admin.TabularInline):
    model = GalleryImage
    form = GalleryImageForm  # 指定自定义表单

@admin.register(Profile)
class ProfileAdmin(admin.ModelAdmin):
    inlines = [GalleryImageInline]

关键注意事项 #

1. 验证器方法名修复：必须将call改为__call__，这是Django识别自定义验证器的标准接口，原代码中的写法会导致验证器根本不执行。
2. 变更判断逻辑：
   • 模型级的self._changed_fields记录了实例从数据库加载后发生变更的字段，适合全局场景。
   • 表单级的self.changed_data记录了本次表单提交中用户修改的字段，适合Admin等表单交互场景。
3. 移除字段默认验证器：两种方法都需要从ImageField的validators参数中移除ImageValidator，避免默认的全量验证。

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