通过前端禁用提交按钮与后端幂等性校验相结合，可有效防止 laravel 表单重复提交，避免创建多条重复交易记录。
通过前端禁用提交按钮与后端幂等性校验相结合，可有效防止 laravel 表单重复提交，避免创建多条重复交易记录。
在 Web 应用中，用户快速多次点击「提交」按钮是导致重复提交（duplicate submission）的常见原因。如您所述，在 Laravel 9 的离线支付场景中，仅靠前端未做防护时，一次快速连点就可能触发多次 payCart() 请求，进而向 transactions 表插入多条相同用户、相同金额的记录——这不仅破坏数据一致性，还可能引发财务风险。
✅ 推荐解决方案：前端 + 后端双重防护
1. 前端：立即禁用提交按钮（基础但关键）
使用 jQuery（如原答案所示）或现代原生 JavaScript，在表单提交瞬间禁用按钮，防止二次点击：
<form id="create-offline-payment-form" action="{{ route('user.cart.pay') }}" method="post">
@csrf
<input type="hidden" name="shop_id" value="{{ $shop_id }}">
<button id="payment" type="submit" class="btn">پرداخت آفلاین</button>
</form>
<script>
// 使用原生 JS（更轻量、无需 jQuery 依赖）
document.getElementById('create-offline-payment-form').addEventListener('submit', function(e) {
const btn = this.querySelector('button[type="submit"]');
btn.disabled = true;
btn.textContent = 'در حال پردازش...'; // 可选：提供用户反馈
});
</script>⚠️ 注意：此方法仅防“用户误操作”，不能替代后端校验——因为用户可绕过 JS（禁用脚本、重放请求等）。
2. 后端：实现幂等性控制（强制保障）
在 payCart() 方法中引入唯一性约束或防重令牌（Idempotency Key），确保同一业务请求仅成功处理一次：
方案 A：使用一次性隐藏 Token（推荐，零数据库改造）
在 Blade 表单中添加服务端生成的一次性 token：
<form id="create-offline-payment-form" action="{{ route('user.cart.pay') }}" method="post">
@csrf
<input type="hidden" name="shop_id" value="{{ $shop_id }}">
<input type="hidden" name="idempotency_token" value="{{ Str::uuid() }}">
<button type="submit" class="btn">پرداخت آفلاین</button>
</form>在控制器中校验该 token 是否已使用（例如存入缓存 10 分钟）：
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Str;
public function payCart(Request $request)
{
$token = $request->input('idempotency_token');
// 检查 token 是否已存在（已处理过）
if (Cache::has('idempotency:'.$token)) {
return redirect()->route('user.cart.paid')->with('warning', 'درخواست قبلاً پردازش شده است.');
}
// 标记 token 为已使用（缓存 10 分钟，覆盖正常支付耗时）
Cache::put('idempotency:'.$token, true, 600);
// 执行核心业务逻辑
Transaction::create([
'seller_id' => Auth::id(),
'amount' => $this->cartSum(),
'token' => $token, // 可选：记录用于审计
]);
return redirect()->route('user.cart.paid');
}方案 B：数据库唯一索引（强一致性）
为 transactions 表添加复合唯一索引（如 seller_id + created_at 不够可靠，建议新增 idempotency_hash 字段）：
// 迁移文件中
Schema::table('transactions', function (Blueprint $table) {
$table->string('idempotency_hash')->nullable()->unique();
});控制器中生成哈希并写入：
$hash = md5(Auth::id() . $this->cartSum() . now()->format('YmdHis'));
Transaction::create([
'seller_id' => Auth::id(),
'amount' => $this->cartSum(),
'idempotency_hash' => $hash,
]);Laravel 会自动捕获 UniqueConstraintViolationException，可全局异常处理器统一返回友好提示。
✅ 最佳实践总结
- ✅ 必做：前端禁用按钮 + 后端幂等校验（推荐
Cache方案，简单高效）； - ✅ 进阶：对敏感操作（如支付）增加「支付中」状态页 + 防刷新机制（如
history.replaceState）； - ❌ 避免仅依赖
@csrf或session控制——它们不解决重复提交问题； - ? 提示用户：按钮文字动态变化（如“پرداخت آفلاین → در حال پردازش…”），提升体验与信任感。
双重防护下，即使用户狂点按钮、刷新页面或重发请求，系统也只会创建一条有效交易记录，真正实现健壮、可靠的支付流程。
