Django formtools Wizard done函数未执行，提交后跳回第一步

1. 步骤配置不匹配 #

• 检查form_list或get_form_list()返回的步骤顺序、数量是否准确。如果最后一步的标识未在配置中定义，向导会判定流程未完成，直接跳回起始步骤。
• 核对get_step_url()或done()内的步骤判断逻辑，是否误将最后一步标记为未完成状态。

2. Session数据损坏或丢失 #

• 确认Session功能正常启用：项目配置中需存在SESSION_ENGINE（默认是django.contrib.sessions.backends.db），且中间件django.contrib.sessions.middleware.SessionMiddleware已添加到MIDDLEWARE列表。
• 表单提交时若出现Session失效（如超时、浏览器禁用Cookie），向导会重置流程到第一步。可在中间步骤打印self.storage.get_current_step()和self.storage.get_step_data()，验证Session中存储的步骤数据是否在提交最后一步时丢失。

3. 表单隐性验证失败 #

• 最后一步的表单可能存在未暴露的验证错误：比如某个后端必填字段未在前端渲染，或clean()方法抛出了未捕获的异常。这种情况下向导不会展示错误提示（若前端未处理），直接回退到第一步。
• 临时排查方案：在最后一步的表单类中添加print(self.errors)，或在post()方法中打印form.errors，确认是否存在未处理的验证问题。

4. URL配置或路由异常 #

• 检查向导的URL配置：确保使用wizard_view.as_view()初始化视图，且无额外路由规则拦截请求导致重新导向到初始步骤。
• 确认请求方法：最后一步提交必须是POST请求，若误触发GET请求，向导会直接渲染第一步表单。

5. 自定义方法覆盖导致逻辑偏差 #

• 若重写了post()、process_step()或get_next_step()方法，需检查是否修改了默认流程控制逻辑：
  • 比如get_next_step()错误返回第一步的标识，导致提交后跳转回起始点；
  • process_step()未正确存储步骤数据，导致向导无法识别已完成的步骤。

6. 版本兼容性问题 #

• 确认django-formtools版本与Django版本匹配：不同版本的SessionWizardView流程控制逻辑可能存在差异，比如旧版本中done()的触发条件有细微调整。可尝试升级或降级formtools版本测试。

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