在Django-formtools的SessionWizardView中声明持久化实例变量的问题

问题出在Django类视图的实例生命周期：每次HTTP请求都会创建一个新的视图实例，所以你在__init__里定义的self.variable会在每一步跳转时被重新初始化，自然没法跨步骤保留。

要实现跨步骤持久化，得把数据存在session里，SessionWizardView本身就基于session提供了便捷的存储方式，下面是两种可行方案：

方案1：使用视图自带的self.storage.extra_data #

这是官方推荐的方式，extra_data专门用来存储向导流程中的额外数据，自动绑定到session：

from django.contrib.formtools.wizard.views import SessionWizardView
from django.http import HttpResponse

class MyWizard(SessionWizardView):
    # 假设你的步骤表单是Step1Form、Step2Form
    form_list = [Step1Form, Step2Form]

    def get_form_initial(self, step):
        # 示例：在第一步初始化并存储变量
        if step == '0':
            self.storage.extra_data['persist_var'] = {'user_input': 'initial_value'}
        return super().get_form_initial(step)

    def process_step(self, form):
        # 示例：在第二步更新变量
        if self.steps.current == '1':
            current_data = self.storage.extra_data.get('persist_var', {})
            current_data.update({'step2_data': form.cleaned_data['some_field']})
            self.storage.extra_data['persist_var'] = current_data
        return super().process_step(form)

    def done(self, form_list, **kwargs):
        # 在最后一步获取持久化的变量
        final_var = self.storage.extra_data.get('persist_var', {})
        # 这里写你的后续处理逻辑
        return HttpResponse(f"Final data: {final_var}")

方案2：直接操作self.request.session #

如果你更习惯直接操作session，也可以这么做，注意存储的数据必须是可序列化的：

class MyWizard(SessionWizardView):
    form_list = [Step1Form, Step2Form]

    def process_step(self, form):
        if self.steps.current == '0':
            # 存储数据到session
            self.request.session['persist_var'] = {'step1': form.cleaned_data}
        elif self.steps.current == '1':
            # 更新session中的数据
            existing_data = self.request.session.get('persist_var', {})
            existing_data['step2'] = form.cleaned_data
            self.request.session['persist_var'] = existing_data
        return super().process_step(form)

    def done(self, form_list, **kwargs):
        final_var = self.request.session.get('persist_var', {})
        # 可选：完成后清理session中的变量，避免残留
        if 'persist_var' in self.request.session:
            del self.request.session['persist_var']
        return HttpResponse(f"Final data: {final_var}")

注意事项 #

• 绝对不要用视图实例变量（比如__init__里定义的self.variable）来存跨步骤数据，因为每次请求都会重建实例
• 存在session里的数据必须是JSON可序列化的类型，比如字典、列表、字符串、数字，不能存自定义类实例（如果要存，得先序列化）
• 用self.storage.extra_data的好处是它和向导的session数据绑定，向导完成后会自动清理（如果配置了的话），更符合向导的使用场景

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