为何Django表单验证失败且未调用clean()方法？

咱先拆解你遇到的表单验证失效、clean()不执行的问题，几个关键错误点和修复方法如下：

1. 表单初始化时未传递参数给父类（核心问题） #

你的SingleSampleForm的__init__方法里，调用super时没有传递*args和**kwargs，这会导致表单无法正确绑定POST数据——父类forms.Form需要这些参数来接收传入的请求数据，没传的话表单始终处于未绑定状态，自然不会触发验证流程，clean()也不会被调用。

修复后的__init__方法：

def __init__(self, *args, **kwargs):
    super(SingleSampleForm, self).__init__(*args, **kwargs)  # 必须传递参数
    self.helper = FormHelper()
    self.helper.layout = Layout(
        Field('sample_id', css_class="search-form-label",),
        Submit('submit', 'Search sample', css_class='upload-btn')
    )
    self.helper.form_method = 'POST'

2. clean()方法返回值错误 #

clean()方法要求返回完整的cleaned_data字典，而你只返回了sample_id单个值，这会破坏表单的验证链，即使前面的步骤没问题，后续逻辑也会出错。

修复后的clean()方法：

def clean(self):
    print('CLEAN')
    cleaned_data = super().clean()  # 先获取父类处理后的cleaned_data
    sample_id = cleaned_data.get('sample_id')
    if not sample_id:
        raise ValidationError('This field is required')
    return cleaned_data  # 返回完整的cleaned_data字典

这里用get()方法获取字段值更安全，避免字段未提交时抛出KeyError。

3. 多余的Meta类 #

你用的是forms.Form（非ModelForm），Meta类在这里完全无效，反而容易造成混淆，直接删除即可：

# 删掉这段无用的代码
# class Meta:
#     fields = ('sample_id',)

4. View类中覆盖类属性的错误 #

在SampleView的post方法里，你执行了self.sample_form = self.sample_form(request.POST)，这会把类属性的SingleSampleForm类覆盖成表单实例，后续请求会出现异常。应该改用局部变量：

def post(self, request, *args, **kwargs):
    # 用局部变量实例化表单，不要覆盖类属性
    sample_form = SingleSampleForm(request.POST)
    if sample_form.is_valid():
        print('Valid')
    else:
        # 打印错误信息便于排查
        print('Errors:', sample_form.errors)
        print('not valid')
    self.context = {
        'sample_form': sample_form,
    }
    return render(request, 'results/single_sample_search.html', self.context)

额外排查技巧 #

• 检查表单绑定状态：在post方法里打印sample_form.is_bound，如果返回False，说明表单未正确绑定POST数据，重点检查初始化参数是否传递正确。
• 查看表单错误：打印sample_form.errors，哪怕clean()没执行，字段级的验证错误（比如必填项为空）也会在这里显示。
• 确认模板包含CSRF令牌：模板里必须添加{% csrf_token %}，否则Django会拒绝POST请求，表单无法正常处理数据。

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