Vue / 系统课时

防止重复提交

防止重复提交

重复点击、网络延迟和超时重试都可能让同一操作执行多次。本课建立“前端提交锁 + 按钮反馈 + 幂等请求标识”的三层防线,使提交期间无法重入,失败后可恢复交互,并让不确定结果的重试仍指向同一次业务操作。

学习目标

  • 使用提交锁阻止同一页面中的并发提交
  • 让按钮状态与请求生命周期保持一致
  • 正确生成、保留和轮换幂等请求标识

认识三层防线

提交锁负责在函数入口处拒绝重入,按钮禁用负责给用户明确反馈,但这两者只能保护当前页面实例。多标签页、脚本调用或网络超时后的重试仍可能重复到达服务器,因此创建订单、付款、发券等关键操作还需要服务端按幂等标识去重。

防线 解决的问题 不能替代的能力
提交锁 阻止处理函数并发进入 不能防止其他页面或客户端请求
按钮状态 防止连续点击并展示进度 不能作为业务唯一性保证
幂等标识 让同一业务重试返回同一结果 需要服务端存储并校验标识

设计提交状态流

请求开始时先上锁,再发送固定的幂等标识。成功后生成下一次操作的新标识;失败或超时时保留原标识,因为服务端可能已经完成处理。无论成功还是失败,交互锁都必须在 finally 中释放。

防重复提交状态流

实现可恢复的提交组件

下面的组件通过 submitting 同时控制函数重入和按钮状态,并把 Idempotency-Key 放入请求头。接口失败时只释放提交锁,不轮换请求标识;再次提交会复用同一个标识。

vue
<script setup lang="ts">
import { computed, ref } from 'vue'

type OrderResult = {
  id: string
  message?: string
}

const sku = ref('SKU-001')
const quantity = ref(1)
const submitting = ref(false)
const feedback = ref('')
const requestId = ref(crypto.randomUUID())

const canSubmit = computed(
  () => sku.value.trim() !== '' && quantity.value > 0 && !submitting.value,
)

async function submitOrder(): Promise<void> {
  if (submitting.value) return

  if (sku.value.trim() === '' || quantity.value < 1) {
    feedback.value = '请填写有效商品和数量'
    return
  }

  submitting.value = true
  feedback.value = ''
  const currentRequestId = requestId.value

  try {
    const response = await fetch('/api/orders', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Idempotency-Key': currentRequestId,
      },
      body: JSON.stringify({
        sku: sku.value.trim(),
        quantity: quantity.value,
      }),
    })

    const body = (await response.json().catch(() => ({}))) as Partial<OrderResult>

    if (!response.ok) {
      throw new Error(body.message ?? `HTTP ${response.status}`)
    }

    if (typeof body.id !== 'string') {
      throw new Error('响应缺少订单 ID')
    }

    feedback.value = `创建成功:${body.id}`
    requestId.value = crypto.randomUUID()
  } catch (error) {
    const message = error instanceof Error ? error.message : '未知错误'
    feedback.value = `提交失败,可使用原请求标识重试:${message}`
  } finally {
    submitting.value = false
  }
}
</script>

<template>
  <form @submit.prevent="submitOrder">
    <label>
      商品编码
      <input v-model.trim="sku" />
    </label>

    <label>
      数量
      <input v-model.number="quantity" min="1" type="number" />
    </label>

    <button :disabled="!canSubmit" type="submit">
      {{ submitting ? '提交中…' : '提交订单' }}
    </button>

    <p>请求标识:{{ requestId }}</p>
    <p aria-live="polite">{{ feedback }}</p>
  </form>
</template>

预期结果

text
首次点击:按钮显示“提交中…”并被禁用
请求期间再次触发:提交函数立即返回,不发送第二个请求
成功:显示“创建成功:<ID>”,随后生成新的请求标识
失败或超时:按钮恢复可用,原请求标识保留供安全重试

实际的 <ID>、请求耗时和错误信息由后端响应决定。

约定服务端幂等行为

服务端应把幂等标识与当前用户、接口和请求摘要共同校验。同一标识与相同请求再次到达时,应返回第一次处理结果;同一标识携带不同请求内容时,应拒绝并返回冲突错误。只有服务端确认成功后,前端才生成新的标识。

提交锁不能代替业务唯一约束。例如订单号、支付流水号或领取记录仍应建立唯一索引,并在事务中处理。幂等记录也需要合理的有效期和结果缓存策略,否则标识无限增长会形成存储负担。

验证失败恢复

可在浏览器开发者工具中降低网速或让接口返回错误,确认按钮在请求结束后恢复。还要检查超时后立即重试时,请求头中的 Idempotency-Key 是否保持不变;成功提交下一笔业务时,该值才应更新。

不要在点击按钮时提前生成新标识,也不要只依赖 :disabled。键盘提交、程序调用和自动化测试都可能绕过按钮,因此函数入口的锁仍然必需。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

防止重复提交

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通