Django forms继承使用时子类表单无法读取image字段值如何解决

问题原因 #

你的代码核心错误是Django表单的字段清洗方法没有返回清洗后的值，其次可排查前端表单的文件上传配置：

1. clean_<字段名>方法必须返回值
   Django中所有clean_xxx格式的字段清洗方法，返回值会被写入表单的cleaned_data字典。如果方法没有主动返回值，默认返回None，会直接覆盖原本读取到的image字段值，所以你拿到的永远是None，也不会触发后续的校验逻辑。
   你代码里父类EditModuleForm的clean_image方法、子类NewCategoryForm的clean_image方法都没有返回值，这是最直接的问题。

2. 前端文件上传配置缺失
   如果修正清洗方法后仍然拿不到值，检查提交表单的前端配置：HTML的<form>标签必须添加enctype="multipart/form-data"属性，否则浏览器不会传输文件内容，后端自然读取不到image字段。如果是接口提交，要确认请求格式为multipart/form-data。

修正后的代码 #

class EditModuleForm(forms.Form):
    category_name = forms.CharField(label='Name', max_length=100)
    image = forms.ImageField(label='Icon', required=False)

    def clean_image(self):
        image = self.cleaned_data.get('image', None)
        if image:
            # 注意：check_image_size如果校验不通过，需要抛出ValidationError才能触发表单校验失败
            check_image_size(image)
        # 返回清洗后的值
        return image


class NewCategoryForm(EditModuleForm):
    category_slug = forms.CharField(label="Slug", max_length=10)
    field_order = ['category_name', 'category_slug', 'image']

    def clean_image(self):
        # 拿到父类清洗后的结果直接返回即可
        return super().clean_image()

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