订阅Stripe Webhook charge.refund.updated事件引发循环请求的解决方案咨询

以下是几个无需持久化ignore字段的可行方案：

方案1：通过API请求ID过滤自触发事件 #

当你调用stripe.refunds.update更新metadata时，Stripe会返回该请求的唯一ID（SDK中可直接获取）。你可以将这个ID暂存（比如用内存缓存或带过期时间的键值存储），在Webhook处理函数中检查事件的request.id是否匹配暂存的ID，若匹配则跳过处理。

示例（Node.js）：

const stripe = require('stripe')('your_secret_key');
const cache = new Map(); // 生产环境可替换为Redis等，设置5分钟过期时间

// 更新refund metadata的函数
async function addFinanceMetadata(refundId) {
  const updateResponse = await stripe.refunds.update(refundId, {
    metadata: { finance_export_id: 'FIN-12345' }
  });
  // 暂存请求ID，5分钟后自动清理
  cache.set(updateResponse.requestId, true);
  setTimeout(() => cache.delete(updateResponse.requestId), 5*60*1000);
}

// Webhook处理函数
async function handleRefundUpdated(event) {
  const refund = event.data.object;
  // 跳过由自身API请求触发的事件
  if (event.request && cache.has(event.request.id)) {
    return;
  }

  // 处理真实的refund变更逻辑
  await addFinanceMetadata(refund.id);
}

该方案不会污染refund实体的metadata，且缓存过期后不会影响后续真实变更的处理。

方案2：通过事件变更内容过滤 #

利用Stripe事件自带的previous_attributes字段，判断当前事件是否由你添加特定metadata触发：

示例（Node.js）：

async function handleRefundUpdated(event) {
  const refund = event.data.object;
  const prevMetadata = event.previous_attributes.metadata || {};
  
  // 定义我们要添加的财务字段
  const targetFinanceField = 'finance_export_id';
  const currentHasField = refund.metadata[targetFinanceField] !== undefined;
  const prevHadField = prevMetadata[targetFinanceField] !== undefined;

  // 若本次事件仅为添加目标财务字段导致，直接跳过
  if (currentHasField && !prevHadField) {
    // 可选：额外校验是否只有该字段发生变更
    const changedMetadataKeys = Object.keys(refund.metadata).filter(key => 
      refund.metadata[key] !== prevMetadata[key]
    );
    if (changedMetadataKeys.length === 1 && changedMetadataKeys[0] === targetFinanceField) {
      return;
    }
  }

  // 处理真实的refund变更逻辑
  await addFinanceMetadata(refund.id);
}

该方案无需额外存储，直接通过事件本身的内容判断，适合业务逻辑较简单的场景。

方案3：拆分Webhook端点 #

将业务逻辑拆分到两个独立的Webhook端点：

• 一个端点仅监听charge.refund.updated事件中非metadata变更的情况（通过Stripe Webhook过滤规则配置）
• 另一个端点不订阅自动触发事件，仅在需要主动添加财务metadata时调用

此方案需依赖Stripe的Webhook过滤能力，配置相对复杂，适合业务逻辑拆分清晰的场景。

内容的提问来源于stack exchange，提问作者zhuber