游戏 AI / 系统课时
剧情为什么突然重复触发
剧情为什么突然重复触发
剧情动作重复执行时,不要先把原因归结为“模型重复生成”。更常见的根因是事件被重复消费、重试没有幂等保护,或状态回写发生竞态。本文按照事件进入、处理、回写三个阶段,定位重复触发并验证修复是否真正生效。
学习目标
- 区分重复事件、重复消费与重复回写
- 使用事件 ID 和状态版本建立幂等边界
- 通过重试与并发场景验证剧情不会重复执行
先判断重复发生在哪一层
先为一次剧情动作记录唯一 eventId、actionId、attempt、stateVersion 和处理时间。然后观察重复结果是否对应同一个 eventId。
分开比对投递 ID、权威任务实例 ID 和业务副作用键。同一事件多次投递可能来自确认丢失;不同事件 ID 指向同一任务实例可能是补偿或发布重复。状态或奖励增长次数要从提交后的存储确认,不能按消费尝试次数推断。

检查事件是否被重复发布或重复消费
第一步看事件源。一个玩家操作可能同时经过客户端重试、服务端补偿和异步任务,如果没有统一的事件 ID,就很难判断它们是不是同一业务事实。
再检查消费者承诺的投递语义。对允许重复投递的队列,处理成功后才确认;确认丢失时重试应读到持久回执。记为“已处理”与写入副作用必须具备同一提交边界。如果先落去重记录再发生错误,可能永久漏掉副作用。
用两个键处理投递重试和业务重复
将代码保存为 reward_once.py 并运行 python reward_once.py。event_id 去重本次投递,instance 标识一次性任务实例。可信完成凭据由任务系统预先写入 completed;服务器固定奖励 10 分。所有表按同一存档、分支和玩家范围查找。SQLite BEGIN IMMEDIATE 在校验与写入前获取写事务,两个连接的写事务不会同时执行。SQLite 事务
import sqlite3
SCHEMA = """
CREATE TABLE progress (
save TEXT, branch TEXT, player TEXT, version INTEGER NOT NULL, points INTEGER NOT NULL,
PRIMARY KEY (save, branch, player)
) WITHOUT ROWID;
CREATE TABLE completed (
save TEXT, branch TEXT, player TEXT, instance TEXT,
PRIMARY KEY (save, branch, player, instance)
) WITHOUT ROWID;
CREATE TABLE award (
save TEXT, branch TEXT, player TEXT, instance TEXT, version INTEGER NOT NULL,
PRIMARY KEY (save, branch, player, instance)
) WITHOUT ROWID;
CREATE TABLE receipt (
save TEXT, branch TEXT, player TEXT, event_id TEXT, instance TEXT NOT NULL, version INTEGER NOT NULL,
PRIMARY KEY (save, branch, player, event_id)
) WITHOUT ROWID;
"""
SCOPE = "(save, branch, player) = (?, ?, ?)"
def apply_reward(db, scope, event_id, instance, expected_version):
if any(not isinstance(item, str) or not item for item in (event_id, instance)):
raise ValueError("invalid event or instance")
if type(expected_version) is not int or expected_version < 0:
raise ValueError("invalid version")
with db:
db.execute("BEGIN IMMEDIATE")
receipt = db.execute(
f"SELECT instance, version FROM receipt WHERE {SCOPE} AND event_id = ?", (*scope, event_id)
).fetchone()
if receipt is not None:
if receipt[0] != instance:
raise ValueError("event ID reused for a different task")
return receipt[1]
award = db.execute(
f"SELECT version FROM award WHERE {SCOPE} AND instance = ?", (*scope, instance)
).fetchone()
if award is None:
proof = db.execute(
f"SELECT 1 FROM completed WHERE {SCOPE} AND instance = ?", (*scope, instance)
).fetchone()
if proof is None:
raise ValueError("missing trusted completion")
updated = db.execute(
f"UPDATE progress SET points = points + 10, version = version + 1 WHERE {SCOPE} AND version = ?",
(*scope, expected_version),
)
if updated.rowcount != 1:
raise ValueError("stale state")
version = expected_version + 1
db.execute("INSERT INTO award VALUES (?, ?, ?, ?, ?)", (*scope, instance, version))
else:
version = award[0]
db.execute("INSERT INTO receipt VALUES (?, ?, ?, ?, ?, ?)", (*scope, event_id, instance, version))
return version
if __name__ == "__main__":
scope = ("save-01", "main", "player-42")
db = sqlite3.connect(":memory:")
db.executescript(SCHEMA)
with db:
db.execute("INSERT INTO progress VALUES (?, ?, ?, ?, ?)", (*scope, 7, 0))
db.execute("INSERT INTO completed VALUES (?, ?, ?, ?)", (*scope, "escort-1"))
for event_id in ("evt-204", "evt-204", "evt-republished"):
print(event_id, apply_reward(db, scope, event_id, "escort-1", 7))
print("points:", db.execute("SELECT points FROM progress").fetchone()[0])
db.close()evt-204 8
evt-204 8
evt-republished 8
points: 10业务奖励只加一次。该示例的所有写入均在同一个 SQLite 数据库内。队列消费者应在事务提交后才确认;需要调用外部服务时,可同事务写入待发送记录,由外部接收端使用同一业务键去重。未知结果应查询回执或对账。
用故障注入验证不会再重复
用两个独立连接并发提交同一事件,再模拟提交成功后丢失确认、写入回执前异常和不同事件 ID 指向同一任务。断言奖励余额、版本、回执和业务奖励记录,不以尝试日志替代结果。下一课检查已经传播的错误记忆如何隔离及修正。