Django表单抛出ValidationError时如何保留状态并返回变量？

我构建了一个自定义表单，包含多个存储模型主键的自定义字段，因此未使用clean_<field>()方法，仅使用clean()方法。获取数据后，若字段未包含特定输入则抛出ValidationError，但不希望表单输入被完全重置。请问是否有办法在提交时保存表单状态，或抛出ValidationError时返回变量？

表单代码如下：

def clean(self):
    data = self.data
    my_data = data.getlist('my_data')
    # ... use my_data to create pandas dataframe ...
    missing = df.loc[( ((df['status'] == 'report') | (df['status'] == 'toconfirm')) & (df['evidence'] == ''))]
    if not missing.empty:
        error_ids = missing['obj'].tolist()
        error_variants = [str(o) for o in error_ids]
        error_variants = "; ".join(error_variants)
        raise(forms.ValidationError(('%(value)s incorrect'), params={'value': error_variants}, ))
    # ** here can I return dataframe, and re-set up my form? **

此处能否返回DataFrame并重新初始化表单？

当然有办法！你遇到的问题核心是直接抛出ValidationError会清空表单的已输入数据并回到初始状态，同时你需要传递额外的DataFrame数据到前端。下面分步骤解决：

1. 用add_error()替代直接抛出ValidationError，保留表单输入状态 #

直接在clean()里raise ValidationError会触发表单的全局错误处理，导致所有已输入数据被重置。改用self.add_error()方法可以只添加错误信息，而保留用户的输入内容：

def clean(self):
    data = self.data
    my_data = data.getlist('my_data')
    # ... 你的DataFrame创建逻辑 ...
    missing = df.loc[((df['status'] == 'report') | (df['status'] == 'toconfirm')) & (df['evidence'] == '')]
    
    if not missing.empty:
        error_ids = missing['obj'].tolist()
        error_variants = "; ".join(str(o) for o in error_ids)
        # 添加非字段级错误，不会重置表单输入
        self.add_error(
            None,  # 传入None表示这是全局非字段错误，也可以指定具体字段
            forms.ValidationError('%(value)s incorrect', params={'value': error_variants})
        )
        # 将需要传递的DataFrame存入表单实例属性
        self.missing_df = missing
    
    # 记得返回清理后的数据（即使有错误，也需要返回）
    return data

2. 将DataFrame传递到模板并按需重新初始化表单 #

在视图函数中，当表单验证失败时，你可以从表单实例中取出之前存储的missing_df，然后传递到模板上下文；如果需要基于这个DataFrame调整表单状态（比如标记特定字段），也可以在视图中修改表单：

def your_view(request):
    if request.method == 'POST':
        form = YourCustomForm(request.POST)
        if form.is_valid():
            # 处理验证通过的逻辑
            # ...
            return redirect('success_page')
        else:
            # 从表单实例获取存储的DataFrame（如果有的话）
            missing_df = getattr(form, 'missing_df', None)
            # 如果需要基于DataFrame重新设置表单的某些状态
            if missing_df is not None:
                # 比如给特定字段添加提示，或者设置初始值（注意不要覆盖用户已输入的内容）
                # form.fields['some_field'].widget.attrs['class'] = 'error-highlight'
                pass
            # 将表单和DataFrame一起传到模板
            return render(request, 'your_template.html', {
                'form': form,
                'missing_df': missing_df
            })
    else:
        form = YourCustomForm()
    return render(request, 'your_template.html', {'form': form})

在模板中，你就可以使用missing_df做任何你需要的展示逻辑，同时表单会自动保留用户之前的输入内容，只显示错误提示。

补充说明 #

• 为什么add_error()能保留输入？因为它只是向表单的错误集合中添加错误，不会触发cleaned_data的清空逻辑，表单会继续保留用户提交的原始数据。
• 如果需要针对特定字段标记错误，只需要把add_error()的第一个参数改成字段名（比如self.add_error('my_data', ...)），这样错误会关联到对应的字段，用户体验更好。

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