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

事件顺序错了会怎样

事件顺序错了会怎样

奖励发放、任务完成和剧情解锁往往存在明确的前置条件。如果这些事件只是在代码里“差不多同时执行”,一次重试、异步回调或队列乱序就可能让玩家提前解锁剧情,甚至重复领取奖励。本节用显式顺序和状态校验把这种问题固定下来。

学习目标

  • 识别奖励、任务完成与剧情解锁之间的时序依赖
  • 用前置条件阻止乱序事件污染状态
  • 让正确顺序可以验证,让错误顺序能够快速失败

时序依赖本质上是状态前置条件

假设击败首领后需要完成三件事:先把任务标记为完成,再发放任务奖励,最后解锁下一段剧情。这里的重点不是代码写成三行还是三个函数,而是每一步都依赖前一步已经成立。

如果 StoryUnlocked 在 QuestCompleted 之前执行,系统就可能出现“剧情已开放,但任务仍显示进行中”的矛盾状态。如果 RewardGranted 可以在任务完成前执行,重试逻辑还可能导致奖励被重复领取。

因此顺序不能只靠调用者自觉遵守,而应该编码为事件处理器能够检查的规则。

任务完成、奖励发放与剧情解锁时序

把顺序约束写进事件处理器

下面的示例定义三个事件,并在每一步检查必须已经成立的状态。这样即使调用方传错顺序,系统也不会悄悄生成不一致数据。

ts
type State = {
  questCompleted: boolean;
  rewardGranted: boolean;
  storyUnlocked: boolean;
};

type GameEvent =
  | { type: "QuestCompleted" }
  | { type: "RewardGranted" }
  | { type: "StoryUnlocked" };

function applyEvent(state: State, event: GameEvent): State {
  const next = { ...state };

  switch (event.type) {
    case "QuestCompleted":
      next.questCompleted = true;
      return next;

    case "RewardGranted":
      // 奖励只能在任务已经完成后发放。
      if (!state.questCompleted) {
        throw new Error("reward requires completed quest");
      }
      next.rewardGranted = true;
      return next;

    case "StoryUnlocked":
      // 剧情解锁依赖奖励阶段已经成功完成。
      if (!state.rewardGranted) {
        throw new Error("story unlock requires granted reward");
      }
      next.storyUnlocked = true;
      return next;
  }
}

function run(events: GameEvent[]): State {
  let state: State = {
    questCompleted: false,
    rewardGranted: false,
    storyUnlocked: false
  };

  for (const event of events) {
    state = applyEvent(state, event);
  }
  return state;
}

const correct = run([
  { type: "QuestCompleted" },
  { type: "RewardGranted" },
  { type: "StoryUnlocked" }
]);

console.log(JSON.stringify(correct));

try {
  run([
    { type: "StoryUnlocked" },
    { type: "QuestCompleted" }
  ]);
} catch (error) {
  console.log((error as Error).message);
}

预期输出:

text
{"questCompleted":true,"rewardGranted":true,"storyUnlocked":true}
story unlock requires granted reward

这里的异常不是为了“让程序更容易崩”,而是为了阻止非法状态继续传播。实际服务中可以把这种失败转换成拒绝消费、重试、死信队列或告警,但核心原则不变:顺序错误必须可见,而不是静默接受。

不要只依赖消息到达顺序

即使业务代码按正确顺序发布事件,分布式环境中的重试、并发消费者和网络延迟仍可能改变实际处理顺序。因此可靠实现通常需要两层保护:上游尽量保证同一剧情链路按顺序发布,下游仍然根据当前状态验证前置条件。

如果事件来自消息队列,可以为同一任务或同一玩家选择稳定的分区键,让相关事件尽可能落到同一有序分区;但这只能降低乱序概率,不能替代状态检查。消费者重启、人工补偿或历史事件回放时,处理器仍必须知道什么状态才允许执行下一步。

同时处理重复事件

时序问题经常和重复投递一起出现。例如 RewardGranted 因超时被重新发送,如果处理器每次都直接增加金币,即使事件顺序正确也会发生重复奖励。

因此具有副作用的事件通常还需要幂等条件:奖励已经发放时再次收到同一语义事件,应返回当前状态而不是再次执行;剧情已经解锁时再次处理解锁事件,也不应该重复触发一次性动画、邮件或成就。

顺序控制最终不是维护一张“调用先后表”,而是把每个事件允许发生的条件固化在状态模型里。这样无论事件来自同步调用、消息队列还是存档回放,系统都能判断当前这一步是否真正合法。

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

目录与阅读设置

阅读设置

17

记录一个想法

事件顺序错了会怎样

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

登录哪都通