Vue / 系统课时
防止重复提交
防止重复提交
重复点击、网络延迟和超时重试都可能让同一操作执行多次。本课建立“前端提交锁 + 按钮反馈 + 幂等请求标识”的三层防线,使提交期间无法重入,失败后可恢复交互,并让不确定结果的重试仍指向同一次业务操作。
学习目标
- 使用提交锁阻止同一页面中的并发提交
- 让按钮状态与请求生命周期保持一致
- 正确生成、保留和轮换幂等请求标识
认识三层防线
提交锁负责在函数入口处拒绝重入,按钮禁用负责给用户明确反馈,但这两者只能保护当前页面实例。多标签页、脚本调用或网络超时后的重试仍可能重复到达服务器,因此创建订单、付款、发券等关键操作还需要服务端按幂等标识去重。
| 防线 | 解决的问题 | 不能替代的能力 |
|---|---|---|
| 提交锁 | 阻止处理函数并发进入 | 不能防止其他页面或客户端请求 |
| 按钮状态 | 防止连续点击并展示进度 | 不能作为业务唯一性保证 |
| 幂等标识 | 让同一业务重试返回同一结果 | 需要服务端存储并校验标识 |
设计提交状态流
请求开始时先上锁,再发送固定的幂等标识。成功后生成下一次操作的新标识;失败或超时时保留原标识,因为服务端可能已经完成处理。无论成功还是失败,交互锁都必须在 finally 中释放。

实现可恢复的提交组件
下面的组件通过 submitting 同时控制函数重入和按钮状态,并把 Idempotency-Key 放入请求头。接口失败时只释放提交锁,不轮换请求标识;再次提交会复用同一个标识。
<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>预期结果
首次点击:按钮显示“提交中…”并被禁用
请求期间再次触发:提交函数立即返回,不发送第二个请求
成功:显示“创建成功:<ID>”,随后生成新的请求标识
失败或超时:按钮恢复可用,原请求标识保留供安全重试实际的 <ID>、请求耗时和错误信息由后端响应决定。
约定服务端幂等行为
服务端应把幂等标识与当前用户、接口和请求摘要共同校验。同一标识与相同请求再次到达时,应返回第一次处理结果;同一标识携带不同请求内容时,应拒绝并返回冲突错误。只有服务端确认成功后,前端才生成新的标识。
提交锁不能代替业务唯一约束。例如订单号、支付流水号或领取记录仍应建立唯一索引,并在事务中处理。幂等记录也需要合理的有效期和结果缓存策略,否则标识无限增长会形成存储负担。
验证失败恢复
可在浏览器开发者工具中降低网速或让接口返回错误,确认按钮在请求结束后恢复。还要检查超时后立即重试时,请求头中的 Idempotency-Key 是否保持不变;成功提交下一笔业务时,该值才应更新。
不要在点击按钮时提前生成新标识,也不要只依赖 :disabled。键盘提交、程序调用和自动化测试都可能绕过按钮,因此函数入口的锁仍然必需。