游戏叙事与剧情 / 系统课时
事件顺序错了会怎样
事件顺序错了会怎样
奖励发放、任务完成和剧情解锁往往存在明确的前置条件。如果这些事件只是在代码里“差不多同时执行”,一次重试、异步回调或队列乱序就可能让玩家提前解锁剧情,甚至重复领取奖励。本节用显式顺序和状态校验把这种问题固定下来。
学习目标
- 识别奖励、任务完成与剧情解锁之间的时序依赖
- 用前置条件阻止乱序事件污染状态
- 让正确顺序可以验证,让错误顺序能够快速失败
时序依赖本质上是状态前置条件
假设击败首领后需要完成三件事:先把任务标记为完成,再发放任务奖励,最后解锁下一段剧情。这里的重点不是代码写成三行还是三个函数,而是每一步都依赖前一步已经成立。
如果 StoryUnlocked 在 QuestCompleted 之前执行,系统就可能出现“剧情已开放,但任务仍显示进行中”的矛盾状态。如果 RewardGranted 可以在任务完成前执行,重试逻辑还可能导致奖励被重复领取。
因此顺序不能只靠调用者自觉遵守,而应该编码为事件处理器能够检查的规则。

把顺序约束写进事件处理器
下面的示例定义三个事件,并在每一步检查必须已经成立的状态。这样即使调用方传错顺序,系统也不会悄悄生成不一致数据。
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);
}预期输出:
{"questCompleted":true,"rewardGranted":true,"storyUnlocked":true}
story unlock requires granted reward这里的异常不是为了“让程序更容易崩”,而是为了阻止非法状态继续传播。实际服务中可以把这种失败转换成拒绝消费、重试、死信队列或告警,但核心原则不变:顺序错误必须可见,而不是静默接受。
不要只依赖消息到达顺序
即使业务代码按正确顺序发布事件,分布式环境中的重试、并发消费者和网络延迟仍可能改变实际处理顺序。因此可靠实现通常需要两层保护:上游尽量保证同一剧情链路按顺序发布,下游仍然根据当前状态验证前置条件。
如果事件来自消息队列,可以为同一任务或同一玩家选择稳定的分区键,让相关事件尽可能落到同一有序分区;但这只能降低乱序概率,不能替代状态检查。消费者重启、人工补偿或历史事件回放时,处理器仍必须知道什么状态才允许执行下一步。
同时处理重复事件
时序问题经常和重复投递一起出现。例如 RewardGranted 因超时被重新发送,如果处理器每次都直接增加金币,即使事件顺序正确也会发生重复奖励。
因此具有副作用的事件通常还需要幂等条件:奖励已经发放时再次收到同一语义事件,应返回当前状态而不是再次执行;剧情已经解锁时再次处理解锁事件,也不应该重复触发一次性动画、邮件或成就。
顺序控制最终不是维护一张“调用先后表”,而是把每个事件允许发生的条件固化在状态模型里。这样无论事件来自同步调用、消息队列还是存档回放,系统都能判断当前这一步是否真正合法。