游戏叙事与剧情 / 系统课时

重复事件如何安全处理

重复事件如何安全处理

剧情事件可能因网络重试、消息重投或客户端重复提交被触发多次。如果处理器每次都直接加奖励、好感或任务进度,同一个事实就会被计算多次。本节用“事件唯一标识 + 幂等处理”把重复触发变成可识别、可忽略的正常情况。

学习目标

  • 为每次业务事件设计稳定且可追踪的唯一标识
  • 用幂等检查避免奖励、好感和进度重复累加
  • 理解“判重”和“状态更新”为什么要作为一个原子过程设计

重复触发真正危险在哪里

重复事件并不等于业务真的发生了两次。常见情况是客户端超时后重试、消息队列重新投递,或者服务端已经处理成功但确认响应丢失。此时事件内容完全相同,只是再次到达处理器。

假设“修复桥梁”第一次完成时应该增加 100 金币、5 点好感并推进一次任务进度。如果同一事件被处理两次,三个状态都会被放大。后续分支读取这些错误值后,问题会继续扩散,单纯回滚某一项通常已经不够。

因此,幂等处理的目标不是禁止重试,而是让同一个业务事实无论到达多少次,最终状态都只变化一次。

用事件 ID 建立判重边界

每个会改变状态的事件都应携带稳定的 eventId。这个 ID 表示“这一次业务事实”,而不是“这一次 HTTP 请求”或“这一次消息投递”。同一个事件被重试时必须复用原 ID,否则服务端无法判断它们是否属于同一次事实。

重复事件幂等处理流程

下面的最小示例用内存 Set 保存已经处理的 ID,演示同一事件执行两次时只生效一次:

ts
type StoryState = {
  gold: number;
  favor: number;
  progress: number;
};

type StoryEvent = {
  eventId: string;
  goldDelta: number;
  favorDelta: number;
  progressDelta: number;
};

const state: StoryState = { gold: 0, favor: 0, progress: 0 };
const handledIds = new Set<string>();

function handleEvent(event: StoryEvent): void {
  if (handledIds.has(event.eventId)) {
    console.log(`duplicate ignored ${event.eventId}`);
    return;
  }

  // 单进程示例中先完成状态变化,再记录该事件已处理。
  state.gold += event.goldDelta;
  state.favor += event.favorDelta;
  state.progress += event.progressDelta;
  handledIds.add(event.eventId);

  console.log(`accepted event ${event.eventId}`);
}

const event: StoryEvent = {
  eventId: "evt-1001",
  goldDelta: 100,
  favorDelta: 5,
  progressDelta: 1
};

handleEvent(event);
handleEvent(event);

console.log(`gold=${state.gold}`);
console.log(`favor=${state.favor}`);
console.log(`progress=${state.progress}`);

预期输出:

text
accepted event evt-1001
duplicate ignored evt-1001
gold=100
favor=5
progress=1

第二次调用没有再次修改状态,说明判重键真正约束了“业务效果只能发生一次”。

判重必须和状态更新一起提交

上面的内存示例只适合说明规则。生产环境如果先写入“已处理”再更新剧情状态,进程可能在中途崩溃,导致事件以后永远被跳过;如果先更新状态再记录 ID,崩溃后重试又可能重复计算。

更稳妥的做法是让“检查 eventId、修改状态、记录 eventId”处在同一个事务或等价的原子边界中。关系型数据库常见做法是建立事件处理记录表,并对 eventId 加唯一约束;重复插入失败时,处理器即可识别为已执行。使用消息系统时也可以采用 Inbox 模式,把消息接收记录和业务状态更新放进同一数据库事务。

怎样选择事件唯一标识

优先使用事件生产方生成且可长期保存的唯一 ID,例如订单式流水号、UUID 或雪花 ID。关键要求只有两个:同一业务事实重试时 ID 不变,不同业务事实不能共享同一个 ID。

不要用当前时间戳临时拼出判重键,因为同一次重试往往会产生不同时间;也不要只拿“任务 ID”判重,因为同一任务可能合法地产生多次不同事件。事件 ID 定义的是一次事实边界,任务 ID 定义的是业务对象,两者职责不同。

当重复事件被安全忽略后,重试机制就可以大胆存在:网络层负责保证“尽量送到”,幂等层负责保证“只生效一次”。这两层配合,奖励、好感和任务进度才不会因为传输不可靠而失真。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

重复事件如何安全处理

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通