Django表单字段校验后处理模型关联的钩子方法咨询

我正在实现一套标签系统，当前相关模型定义如下：

class Tag(models.Model):
    label = models.CharField(max_length=MAX_TAG_LENGTH)


class TagManager(models.Model):
    tags = models.ManyToManyField(Tag, related_name="referrers")

    def associate_tag(self, tag_label: str):
        ...

我自定义了一个表单字段，支持按逗号分割输入内容，接收用户输入的逗号分隔标签列表：

class TagsField(forms.CharField):
    def to_python(self, value):
        if not value:
            return []
        return [tag.strip() for tag in value.split(',')]

用到上述定义的业务模型和表单代码如下：

class Thing(models.Model):
    tags = models.OneToOneField(TagManager, on_delete=models.SET_NULL, null=True)

class ThingForm(forms.ModelForm):
    tags = TagsField(widget=forms.TextInput(attrs={"placeholder": "Tags", "required": False}))

    class Meta:
        model = Thing
        fields = ["tags"]

遇到的问题 #

按如下方式填充数据并执行表单校验时：

form = ThingForm(data={"tags": ["One", "Two"]})
form.is_valid()

抛出如下错误：

{'tags': ["“[\"One\", \"Two\"]” value must be an integer."]}

初步判断报错原因是表单尝试将字符串化的列表赋值给OneToOneField字段，不符合字段类型要求导致操作失败。
需要实现的逻辑为：字段校验完成后，遍历to_python方法返回的处理结果，针对每个校验通过的标签字符串，调用thing_instance.tags.associate_tag方法完成标签关联。
咨询Django表单是否提供对应“钩子”方法，支持简洁实现上述逻辑。

报错核心原因是ModelForm默认会将同名字段的校验结果直接赋值给模型对应字段，Thing.tags是OneToOneField，预期接收TagManager实例主键（整数类型），但自定义TagsField返回的是标签字符串列表，类型不匹配才触发校验错误。

Django提供了标准内置钩子实现需求，不需要侵入修改核心逻辑，具体实现步骤如下：

• 修正自定义TagsField，补全字段级别的非必填配置，同时兼容列表、逗号字符串两种输入格式
• 重写ModelForm的_post_clean钩子，在校验完成后将标签列表从待赋值的清洗数据中弹出，避免触发OneToOneField的类型校验
• 重写ModelForm的save方法，在实例保存阶段完成TagManager创建、标签关联的逻辑

可直接运行的代码 #

class TagsField(forms.CharField):
    def __init__(self, *args, **kwargs):
        kwargs.setdefault("required", False)
        super().__init__(*args, **kwargs)

    def to_python(self, value):
        if not value:
            return []
        # 兼容测试时传列表、正常输入传逗号字符串两种场景
        if isinstance(value, list):
            return [tag.strip() for tag in value if tag.strip()]
        return [tag.strip() for tag in value.split(',') if tag.strip()]


class ThingForm(forms.ModelForm):
    tags = TagsField(widget=forms.TextInput(attrs={"placeholder": "Tags"}))

    class Meta:
        model = Thing
        fields = ["tags"]

    def _post_clean(self):
        super()._post_clean()
        # 弹出标签列表数据，避免直接赋值给OneToOneField触发类型错误
        self._tag_labels = self.cleaned_data.pop("tags", [])

    def save(self, commit=True):
        instance = super().save(commit=False)
        # 未关联TagManager时先创建实例
        if not instance.tags_id:
            instance.tags = TagManager.objects.create()
        # 遍历标签调用自定义的关联方法
        for label in self._tag_labels:
            instance.tags.associate_tag(label)
        if commit:
            instance.save()
            self.save_m2m()
        return instance

注意点 #

• _post_clean是ModelForm内置的校验后置钩子，执行时机在所有字段校验完成、模型实例字段赋值之前，适合处理这种自定义字段和模型字段类型不匹配的场景
• 表单字段的required参数需要在字段初始化时设置，仅在widget上添加required属性是前端层面的校验，不会生效于后端校验逻辑
• 正常前端使用TextInput输入时，传入的tags参数应该是逗号拼接的字符串，例如"One,Two"，上述代码已经兼容测试时直接传列表的写法。

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