游戏 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 事务

python
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()
text
evt-204 8
evt-204 8
evt-republished 8
points: 10

业务奖励只加一次。该示例的所有写入均在同一个 SQLite 数据库内。队列消费者应在事务提交后才确认;需要调用外部服务时,可同事务写入待发送记录,由外部接收端使用同一业务键去重。未知结果应查询回执或对账。

用故障注入验证不会再重复

用两个独立连接并发提交同一事件,再模拟提交成功后丢失确认、写入回执前异常和不同事件 ID 指向同一任务。断言奖励余额、版本、回执和业务奖励记录,不以尝试日志替代结果。下一课检查已经传播的错误记忆如何隔离及修正。

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

目录与阅读设置

阅读设置

17

记录一个想法

剧情为什么突然重复触发

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

登录哪都通