引言：为何需要唯一标识？
处理高频 Webhook 请求时，您是否担心重复执行导致数据错乱？
例如，用户重复点击支付，导致系统重复扣款。
本教程将教你一个简单但关键的配置技巧，无需任何编程基础。
只需跟着步骤，在 Code 节点中提取关键信息（如订单ID），组合成一个唯一的“锁ID”（Lock Key）。
这能确保即使是完全相同的请求被频繁触发，您的工作流也只会执行一次，从根源上保证流程的幂等性。
配置目的
本次配置的核心目标非常明确。
我们要从 Webhook 传入的数据中，精确地挑出几个能代表“唯一事件”的字段。
例如订单ID、用户ID或事件类型。
然后，我们将这些字段组合成一个独一无二的字符串，即 Lock Key。
这个 Lock Key 将作为后续流程（如分布式锁）的唯一身份证，防止任何重复操作。
前置条件
开始前，您唯一需要做的，就是清楚了解 Webhook 传来的数据长什么样。
您可以在工作流中先单独运行一次 Webhook 节点。
然后点击该节点，在右侧的 “Output” 区域查看其输出的 JSON 数据结构。
请花一分钟时间，找到您认为可以唯一标识一次事件的字段路径。
例如，一个订单创建的 Webhook，其订单ID路径可能是 body.id，用户ID路径可能是 body.customer.id。
核心配置步骤
接下来，我们将通过一个 Code 节点来完成 Lock Key 的生成。
第一步：添加 Code 节点
在您的 Webhook 节点之后，添加一个新的 “Code” 节点。
第二步：设置运行模式
点击 Code 节点，在右侧配置面板中，将 Mode (模式) 设置为 Run Once for Each Item。
这个模式能让我们方便地处理每一条传入的数据。
第三步：粘贴并修改代码
将下方的 JavaScript 代码粘贴到 JavaScript Code 编辑区中。
这段代码的作用是读取输入数据，并添加一个新的 lockKey 字段。
// n8n 会自动将上一个节点的JSON数据放入 $json 变量中 // 1. 定义变量，并替换为您的实际JSON路径 // 请根据您在前置条件中找到的路径，修改下面的内容 const var1 = $json.body.order_id; // 示例：提取订单ID const var2 = $json.body.customer.id; // 示例：提取用户ID const var3 = 'order_created'; // 您也可以使用固定的字符串 // 2. 组合成唯一的 Lock Key 字符串 // 您可以自由增删变量，调整组合方式，确保结果对每次事件都唯一 const lockKey = `lock-key:${var1}-${var2}-${var3}`; // 3. 将新生成的 lockKey 添加到数据中 $json.lockKey = lockKey; // 4. 按 n8n 要求格式返回，将包含原始数据和新lockKey的数据传给下一个节点 return [{ json: $json }]; 第四步：关键参数说明
代码中最关键的部分是前两步的修改：
-
修改变量路径：将
$json.body.order_id和$json.body.customer.id替换为您自己数据中的真实路径。如果只有一个唯一ID，您可以只用var1，删除var2和var3。 -
调整组合逻辑：
lockKey的组合方式非常灵活。您可以使用-、:或任何其他符号连接变量，只要能保证最终结果的唯一性即可。
常见错误排查
配置过程中可能会遇到一些小问题，别担心，通常很容易解决。
错误一：Lock Key 不唯一
现象：流程还是被重复执行了。
原因：您选择用来组合 Lock Key 的字段（如 var1, var2）本身不具备唯一性。
解决方案：请重新检查您的 Webhook 数据，选择真正能唯一标识一次业务操作的字段，例如各种唯一ID（订单ID、支付ID、用户ID、事件ID等）。
错误二：字段提取失败
现象：Code 节点报错，提示类似 `Cannot read properties of undefined`。
原因：您在代码中填写的 JSON 路径是错误的，导致 n8n 没能找到对应的数据。
解决方案：回到 Webhook 节点的输出，逐层核对您的路径。例如，数据是在 body.order.id 而不是 body.id。一个有用的调试技巧是在代码第一行加上 console.log(JSON.stringify($json));，执行后按F12打开浏览器控制台，就能看到完整的数据结构，方便您找到正确路径。
总结：提升流程稳定性
恭喜您！完成这个简单的配置后，您的自动化工作流拥有了“幂等性”的保障。
现在，即使上游系统因为网络问题或其他原因，在短时间内发送了多次完全相同的 Webhook 请求，您的核心业务逻辑也只会执行一次。
这极大地提升了自动化流程的健壮性和数据准确性，让您在处理高频次输入时也能高枕无忧。
