天下无敌APIs的幂等性

后端

2023-12-22 16:35:07

API 幂等性：赋能分布式系统的稳定基石

在分布式系统的浩瀚江湖中，API 幂等性犹如一把天下无敌的秘密武器，赋予系统无与伦比的稳定性，确保其所向披靡，战无不胜。简而言之，API 幂等性指无论接口被调用多少次，系统产生的影响都始终一致，仿佛时光逆流，一切如初。

API 幂等性的关键意义

在分布式系统中，网络延时、服务器故障等因素可能导致接口被重复调用。若缺乏幂等性，这种重复调用恐将酿成数据不一致、系统崩溃等灾难性后果。相反，API 幂等性犹如一面坚不可摧的盾牌，抵御这些隐患，保证系统即使在逆境中亦能岿然不动，稳定如山。

打造 API 幂等性的秘诀

实现 API 幂等性有多种途径，其中最常用的莫过于独一无二的标识符。在执行写操作时，我们可以生成一个唯一的标识符，并将其存储于系统之中。当接口被重复调用时，系统会检查该标识符是否存在，若已存在则略过重复调用，否则才会执行写操作。

银行转账：API 幂等性的现实应用

为了更深入地理解 API 幂等性的魅力，让我们走进银行转账的场景中。当用户使用手机银行进行转账时，系统便会调用银行转账的 API。如果该 API 缺乏幂等性，那么将会发生以下噩梦：

用户连按转账按钮，导致转账操作被重复执行，账户余额因此变得面目全非。
网络延迟导致转账请求被多次发送，账户余额惨遭多次扣除，令用户欲哭无泪。

而有了 API 幂等性的保驾护航，无论用户如何操作，转账行为只会发生一次，账户余额安然无恙，确保转账操作的稳定性和可靠性。

Node.js 中的 API 幂等性实战

为了将理论付诸实践，让我们一起来探索 Node.js 中 API 幂等性的实现方式：

const uniqueIdGenerator = require("unique-id-generator");

const transferMoney = async (senderAccountId, receiverAccountId, amount) => {
  // 生成独一无二的交易 ID
  const transactionId = uniqueIdGenerator();

  // 检查交易 ID 是否已存在于系统中
  const existingTransaction = await Transaction.findOne({ transactionId });

  if (existingTransaction) {
    // 交易 ID 已存在，忽略请求
    return;
  }

  // 创建新的交易记录
  const newTransaction = new Transaction({
    transactionId,
    senderAccountId,
    receiverAccountId,
    amount,
  });

  // 将交易记录保存至数据库
  await newTransaction.save();

  // 执行资金转移
  await transferMoneyFromOneAccountToAnother(senderAccountId, receiverAccountId, amount);
};