Django formtools提交表单时done方法未调用，陷入循环求助

问题核心梳理 #

提交最后一步表单后未触发done方法、跳回第一步，同时出现POST+GET双重请求，大概率是模板表单渲染错误、步骤标识丢失、session配置异常或表单验证失败导致的，以下是针对性修复方案：

1. 解决双重请求问题 #

双重请求通常是表单按钮或标签写法不规范导致：

• 确保提交按钮明确设置type="submit"，避免浏览器默认触发GET请求
• 表单action属性留空（让浏览器自动提交到当前URL），或指定正确的 wizard 路径

示例模板修正：

<form method="post" action="">
  {% csrf_token %}
  <!-- 核心：必须渲染wizard管理字段，包含步骤标识 -->
  {{ wizard.management_form }}
  {{ wizard.form }}
  <button type="submit">
    {% if wizard.steps.current == wizard.steps.last %}提交{% else %}下一步{% endif %}
  </button>
</form>

2. 修复跳回第一步、不触发done方法的问题 #

（1）检查View类配置正确性

确保SessionWizardView子类的form_list顺序正确，done方法定义无语法错误：

# views.py
from formtools.wizard.views import SessionWizardView
from django.http import HttpResponse
from .forms import Step1Form, Step2Form

class MultiStepWizard(SessionWizardView):
    # 按步骤顺序定义表单，键名对应步骤标识
    form_list = [('step1', Step1Form), ('step2', Step2Form)]
    template_name = "multi_step_form.html"

    def done(self, form_list, **kwargs):
        # 处理所有步骤的表单数据
        for form in form_list:
            print(form.cleaned_data)
        return HttpResponse("表单提交完成")

（2）强制渲染步骤管理字段

模板中必须渲染{{ wizard.management_form }}，它包含了识别当前步骤的隐藏字段，缺失会导致步骤重置到初始状态。

（3）验证session中间件配置

formtools依赖session存储步骤数据，确保settings.py中启用Session中间件：

# settings.py
MIDDLEWARE = [
    # 其他中间件...
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    # 其他中间件...
]

（4）排查表单验证错误

最后一步表单验证失败会导致wizard停留在当前步骤，但如果模板未显示错误，可能被误认为跳回第一步。在模板中添加错误提示：

{% if wizard.form.errors %}
  <div style="color: red;">
    {% for field_errors in wizard.form.errors.values %}
      {{ field_errors }}
    {% endfor %}
  </div>
{% endif %}

3. 额外排查技巧 #

• 打开浏览器开发者工具的Network标签，查看POST请求的响应状态码、重定向路径，确认是否因验证失败导致重定向
• 查看Django控制台日志，检查是否有表单验证错误、session异常等信息
• 确保所有表单类都继承自django.forms.Form，无错误的继承关系

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