解决 Inertia.js 与 Vue 3 应用中表单重复提交问题

本文旨在解决基于 inertia.js、vue 3 和 laravel 栈开发时，表单或链接意外触发重复请求的问题。通过深入分析错误的事件绑定、缺乏请求状态管理等常见原因，教程将详细介绍如何利用 useform 的 processing 状态、正确的表单事件处理以及阻止默认行为来有效避免重复提交，并提供优化后的代码示例和最佳实践。

引言：Inertia.js 应用中的表单提交挑战

在现代单页应用（SPA）开发中，结合 Vue 3、Inertia.js 和 Laravel 栈能够提供流畅的用户体验。然而，开发者常会遇到一个常见问题：用户在提交表单或点击链接时，可能会因为快速点击、网络延迟或不正确的事件处理，导致相同的请求被发送多次。这不仅可能造成数据重复创建、更新或删除，还会给服务器带来不必要的负载。本教程将深入探讨这一问题，并提供一套全面的解决方案。

问题分析：导致重复提交的常见原因

重复提交通常源于以下一个或多个因素：

错误的事件绑定： 在 Vue 模板中，将表单提交逻辑绑定到不恰当的事件（例如，将 submit 方法绑定到
元素的 @click 事件）。当用户点击表单内的任何区域时，都会触发 submit 方法，而不是仅在提交按钮被点击或回车时触发。
缺乏请求状态管理： 在请求发送期间，前端没有机制来告知用户当前正在处理请求，也没有阻止用户再次触发相同的操作。
浏览器默认行为未阻止： HTML 表单有其默认的提交行为。如果在使用 JavaScript 处理提交时未显式阻止此默认行为，浏览器可能会在 JavaScript 逻辑执行的同时，也尝试进行一次传统的表单提交。
InertiaLink 的快速点击： 尽管 InertiaLink 旨在提供 SPA 体验，但在极快速的连续点击下，尤其是在网络条件不佳时，也可能出现重复请求的情况。

在提供的代码示例中，主要的重复提交问题来源于

这一行。这意味着表单内的任何点击都会触发 submit 方法，导致请求被多次发送。此外，提交按钮 store post! 的 type 被设置为 button，这本身不会触发表单的 submit 事件，进一步说明了 form @click 是唯一的提交机制，且存在缺陷。

解决方案一：利用 Inertia useForm 的 processing 状态

Inertia.js 的 useForm 辅助函数提供了一个非常实用的 processing 属性，用于指示当前表单是否正在发送请求。我们可以利用这个属性来防止在请求处理期间重复提交。

核心思路： 在 submit 方法的开头检查 this.form.processing。如果为 true，则说明请求正在进行中，直接返回，不执行后续的提交逻辑。

import { defineComponent } from "vue";
import AppLayout from "@/Layouts/AppLayout.vue";
import { useForm } from "@inertiajs/inertia-vue3"; // 引入 useForm

export default defineComponent({
  // ... 其他配置 ...
  setup() {
    const form = useForm({
      title: null,
      content: null,
      image: null,
      region: null,
    });
    return { form };
  },
  methods: {
    submit() {
      // 检查表单是否正在处理中，如果是，则阻止重复提交
      if (this.form.processing) {
        return false;
      }

      this.form.image = this.$refs.photo.files[0];
      this.form.region = this.regionN;

      this.form.post(route("store"), {
        preserveScroll: true, // 提交后保持滚动位置
        onSuccess: () => {
          // 请求成功后重置表单，以便下一次提交
          this.form.reset();
          // 可以添加成功提示或其他逻辑
          console.log("表单提交成功！");
        },
        onError: (errors) => {
          // 处理错误，例如显示验证错误信息
          console.error("表单提交失败：", errors);
        },
        onFinish: () => {
          // 请求完成（无论成功或失败）后执行的逻辑
          console.log("表单请求完成。");
        }
      });
    },
    // ... 其他方法 ...
  },
  // ... 其他生命周期钩子 ...
});

onSuccess 回调与 form.reset()： 在 form.post 方法中，onSuccess 回调会在请求成功并页面更新后执行。在此回调中调用 this.form.reset() 是一个良好的实践，它会将表单的所有字段重置为初始值，为下一次提交做好准备。

解决方案二：正确的表单事件处理与阻止默认行为

将提交逻辑绑定到

元素的 @submit.prevent 事件是处理表单提交的标准且推荐的方式。prevent 修饰符会自动调用 event.preventDefault()，阻止浏览器默认的表单提交行为（如页面刷新），确保 Inertia.js 能够完全控制提交过程。

修改 Vue 模板：

关键改动：

修改为

提交按钮 store post! 的 type 从 button 修改为 submit，这样它就能触发表单的 submit 事件。
提交按钮添加 :disabled="form.processing" 属性，在表单提交期间禁用按钮，提供视觉反馈并防止用户重复点击。
input type="hidden" name="region" v-bind="form.region" 修正为 v-model="form.region" 以确保数据双向绑定正确。

解决方案三：处理 InertiaLink 的重复请求

对于 InertiaLink 导致的重复请求（例如 delete 操作），问题通常不那么常见，因为 InertiaLink 内部已经处理了一定的防抖逻辑。然而，如果用户快速点击，或者后端响应极慢，仍然可能发生。

建议：

后端幂等性： 确保删除或更新操作在后端是幂等的。这意味着即使请求被发送多次，结果也应该是一致的（例如，删除一个已删除的资源不会引发错误，只是返回资源不存在）。
前端禁用链接： 在 InertiaLink 的 onStart 或 onBefore 回调中设置一个状态，禁用链接，并在 onFinish 回调中重新启用。
使用 onBefore 钩子：
```
  delete btn
```
虽然 onBefore 主要是用于确认或条件检查，但它也可以间接用于阻止重复请求，如果结合一个组件内部的 isDeleting 状态变量。

示例代码：优化后的 Vue 组件（Create Page）

注意事项与最佳实践

用户体验 (UX)： 在表单提交期间禁用按钮并显示加载指示器（例如，转动的图标或文本）是良好的用户体验实践。这不仅防止了重复提交，还明确告知用户系统正在处理请求。
后端幂等性： 即使前端采取了防重复提交措施，后端接口也应设计为幂等。对于创建操作，可以考虑使用唯一标识符；对于更新和删除，应确保重复操作不会导致意外结果。
错误处理： 确保 onError 回调能够妥善处理后端返回的验证错误或其他异常，并将友好的错误信息展示给用户。
表单重置： 在 onSuccess 中调用 form.reset() 是一个好习惯，它能清除表单数据，防止用户意外地再次提交相同的内容。