如何用Django内置表单实现多表单向导并避免首次加载报错？

核心问题原因 #

你遇到的问题本质是错误地用POST请求直接加载后续步骤表单：从step_one提交POST后直接渲染step_two视图，此时request.method为POST，Django表单会用POST数据初始化并自动触发验证，但step_two的字段还未填写，因此抛出必填错误。

优选方案：采用PRG模式（Post/Redirect/Get） #

这是处理表单跳转的标准HTTP规范做法，能彻底避免这类问题，同时防止页面刷新导致的重复提交。具体逻辑是：

1. 处理完前一步的POST请求后，重定向到下一步视图
2. 下一步视图通过GET请求加载，初始化空表单，不会触发验证

代码示例 #

第一步视图（step_one）

from django.shortcuts import render, redirect
from .forms import StepOneForm

def step_one(request):
    if request.method == 'POST':
        form = StepOneForm(request.POST)
        if form.is_valid():
            # 将第一步的有效数据存入session，供后续步骤使用
            request.session['step_one_data'] = form.cleaned_data
            # 重定向到第二步，此时第二步是GET请求
            return redirect('step_two')
    else:
        form = StepOneForm()
    return render(request, 'steps/step_one.html', {'form': form})

第二步视图（step_two）

from django.shortcuts import render, redirect
from .forms import StepTwoForm

def step_two(request):
    # 拦截未完成第一步直接访问第二步的请求
    if 'step_one_data' not in request.session:
        return redirect('step_one')
    
    if request.method == 'POST':
        form = StepTwoForm(request.POST)
        if form.is_valid():
            # 取出第一步的数据，合并处理
            step_one_data = request.session.pop('step_one_data')
            # 这里可以执行保存到数据库等逻辑
            # ...
            return redirect('wizard_success')
    else:
        # GET请求初始化空表单，无验证错误
        form = StepTwoForm()
    return render(request, 'steps/step_two.html', {'form': form})

关于隐藏字段的必要性 #

如果严格遵循PRG模式，不需要使用隐藏字段。只有在特殊场景下（比如无法使用重定向），才需要通过隐藏字段标记请求来源，区分“从上个步骤跳转的首次加载”和“当前步骤的提交请求”：

特殊场景下的隐藏字段方案（不推荐） #

在第一步表单中添加隐藏字段标记步骤：

class StepOneForm(forms.Form):
    name = forms.CharField(label="姓名")
    # 标记当前步骤
    source_step = forms.CharField(widget=forms.HiddenInput(), initial='step_one')

第二步视图中判断请求类型：

def step_two(request):
    if request.method == 'POST':
        # 判断是否是从第一步跳转过来的首次请求
        if request.POST.get('source_step') == 'step_one':
            # 初始化空表单，跳过验证
            form = StepTwoForm()
        else:
            # 处理当前步骤的提交请求
            form = StepTwoForm(request.POST)
            if form.is_valid():
                # 处理逻辑
                return redirect('wizard_success')
    else:
        return redirect('step_one')
    return render(request, 'steps/step_two.html', {'form': form})

这种方案仅作为备选，因为它不符合HTTP规范，且存在页面刷新重复提交的风险。

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