Laravel多表单向导：浏览器回退引发重复提交的处理方法

这绝对是多步表单向导里的经典坑！我之前做过一个7步的客户信息采集流程，一模一样的问题——用户回退再点下一步就重复插数据，当时头都大了，后来试了几个办法都挺管用，分享给你：

PRG（Post/Redirect/Get）是处理POST重复提交的黄金准则，核心思路是提交成功后不直接返回页面，而是重定向到下一步的GET路由。但光靠PRG还不够，得配合服务器端的会话状态管理：

• 给每个用户的向导流程维护一个状态（存在Session或者Redis里都行），记录当前已经完成到第几步；
• 当用户提交某一步表单时，先检查会话里的步骤状态：
  • 如果还没完成当前步骤，就处理数据插入、更新状态，然后重定向到下一步；
  • 如果已经完成过当前步骤，直接重定向到下一步，跳过数据插入逻辑。

举个伪代码例子（后端用Python Flask的话）：

# 第二步表单的POST处理
@app.post("/wizard/step2")
def handle_step2_submit(form_data):
    # 从会话里拿当前已完成的步骤
    current_completed_step = session.get("wizard_completed_step", 0)
    
    # 如果已经完成第二步，直接跳第三步，不处理数据
    if current_completed_step >= 2:
        return redirect("/wizard/step3")
    
    # 正常处理数据插入
    save_step2_data_to_db(form_data)
    # 更新会话状态为已完成第二步
    session["wizard_completed_step"] = 2
    # 重定向到第三步的GET页面（关键！避免POST请求留在浏览器历史里）
    return redirect("/wizard/step3")

这样用户回退到第二步再点下一步时，后端检测到已经完成过第二步，直接跳第三步，不会重复插数据。

给每个步骤的表单生成一个唯一的令牌（比如UUID），存在会话里和表单的隐藏字段中。提交时验证令牌有效性，有效则处理数据并失效令牌，无效则拒绝提交：

• 渲染第二步页面时，生成一个唯一令牌存在Session里，同时放到表单隐藏字段；
• 提交第二步表单时，先对比请求里的令牌和Session里的是否一致：
  • 一致则处理数据，然后删除Session里的令牌（防止重复使用）；
  • 不一致（比如回退再提交，令牌已经被删除），就提示用户“该步骤已提交”，直接跳下一步。

前端表单示例：

<form method="POST" action="/wizard/step2">
    <!-- 隐藏令牌字段 -->
    <input type="hidden" name="submit_token" value="{{ session.step2_submit_token }}">
    <!-- 第一步的回显数据 -->
    <p>您第一步填写的姓名：{{ step1_data.name }}</p>
    <!-- 第二步的新字段 -->
    <input type="text" name="phone" required>
    <button type="submit">下一步</button>
</form>

后端处理逻辑：

# 渲染第二步页面
@app.get("/wizard/step2")
def render_step2():
    # 如果还没完成第二步，生成新令牌
    if session.get("wizard_completed_step", 0) < 2:
        session["step2_submit_token"] = uuid.uuid4().hex
    # 获取第一步的已保存数据用于回显
    step1_data = get_step1_data_from_db(session["user_id"])
    return render_template("step2.html", step1_data=step1_data)

# 处理第二步提交
@app.post("/wizard/step2")
def handle_step2_submit(form_data):
    current_completed_step = session.get("wizard_completed_step", 0)
    if current_completed_step >= 2:
        return redirect("/wizard/step3")
    
    # 验证令牌
    submitted_token = form_data.get("submit_token")
    if submitted_token != session.get("step2_submit_token"):
        # 令牌无效，跳回第二步并提示
        return redirect("/wizard/step2?error=already_submitted")
    
    # 处理数据插入
    save_step2_data_to_db(session["user_id"], form_data)
    session["wizard_completed_step"] = 2
    # 删除令牌，防止重复提交
    del session["step2_submit_token"]
    return redirect("/wizard/step3")

给步骤页面添加缓存控制头，让浏览器回退时重新从服务器拉取页面，而不是读本地缓存。这样服务器可以根据会话状态，在页面渲染时就判断该步骤是否已完成：

• 如果已完成，就把表单改成只读状态，“下一步”按钮点击后直接跳转到下一步；
• 如果未完成，正常显示可编辑表单。

比如在后端返回页面时设置响应头：

@app.get("/wizard/step2")
def render_step2():
    response = make_response(render_template("step2.html", ...))
    # 禁用缓存
    response.headers["Cache-Control"] = "no-cache, no-store, must-revalidate"
    response.headers["Pragma"] = "no-cache"
    response.headers["Expires"] = "0"
    return response

最稳妥的组合是PRG模式+会话状态管理，令牌方案可以作为额外的安全层防止恶意重复提交。这样不管用户怎么回退、刷新，都不会出现重复插入数据库的问题。

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