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

失败保存后如何回退

失败保存后如何回退

保存剧情状态最危险的不是“明确失败”,而是只写进去一半:玩家以为存档成功,下一次读档却拿到互相矛盾的变量。本课把保存动作收敛成一个可恢复边界,并用临时文件、原子替换与校验避免半成品存档覆盖最后一次可用状态。

学习目标

  • 识别写入失败、部分保存和异常退出分别会破坏什么
  • 设计“旧存档始终可回退”的保存边界
  • 用校验与故障注入验证回退是否真的有效

先定义什么叫保存成功

一次保存不能以“开始写文件”作为成功标准,而应满足三个条件:新快照已经完整生成、内容通过校验、对外可见的正式存档已一次性切换到新版本。任何一步失败,都应继续保留旧版本。

因此不要直接覆盖 save.json。更安全的做法是先写 save.json.tmp,写完后重新读取并校验,最后用原子重命名替换正式文件。如果进程在临时文件阶段退出,旧存档仍然存在;只有通过校验的新文件才有资格成为正式存档。

剧情存档失败回退流程

把保存写成一个原子边界

下面示例使用 Node.js。它把完整剧情状态序列化到临时文件,写完后做最小结构校验,再用 rename 替换正式存档。多数本地文件系统中,同一文件系统内的重命名可作为最终切换点;如果正式文件和临时文件跨文件系统,就不能依赖这一性质。

ts
import { promises as fs } from "node:fs";

type StoryState = {
  version: number;
  sceneId: string;
  flags: Record<string, boolean>;
};

const savePath = "./save.json";
const tempPath = "./save.json.tmp";

function validateState(value: unknown): asserts value is StoryState {
  if (
    typeof value !== "object" ||
    value === null ||
    typeof (value as StoryState).version !== "number" ||
    typeof (value as StoryState).sceneId !== "string" ||
    typeof (value as StoryState).flags !== "object"
  ) {
    throw new Error("invalid save state");
  }
}

async function saveAtomically(state: StoryState): Promise<void> {
  const json = JSON.stringify(state);

  // 先写临时文件,避免直接破坏最后一次可用存档。
  await fs.writeFile(tempPath, json, "utf8");

  const verifyText = await fs.readFile(tempPath, "utf8");
  const verifyState: unknown = JSON.parse(verifyText);
  validateState(verifyState);

  // 只有完整写入并通过校验后,才切换正式存档。
  await fs.rename(tempPath, savePath);
}

async function main() {
  await saveAtomically({
    version: 7,
    sceneId: "harbor-night",
    flags: { metCaptain: true, gateOpened: false }
  });

  const saved = JSON.parse(await fs.readFile(savePath, "utf8")) as StoryState;
  console.log(saved.version, saved.sceneId, saved.flags.metCaptain);
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

预期输出

text
7 harbor-night true

真实应用还应根据平台补充持久化保证,例如在关键场景使用文件同步能力。这里的核心不是某个 API,而是正式存档永远只指向已验证的完整快照。

部分保存为什么比完整失败更危险

如果剧情状态被拆成多个文件,例如 player.json、quests.json、world.json,逐个覆盖会产生跨文件不一致:玩家数据已经更新,任务数据却仍是旧版本。此时单个文件都合法,但组合起来已经不是同一次存档。

解决办法通常有两种。数据规模较小时,把一次剧情快照写成单个整体文件最简单;必须拆分时,则先写入一个带版本号的新目录,全部成功后再切换一个“当前版本指针”。不要让多个正式文件独立宣布成功。

启动时如何处理遗留临时文件

应用启动时发现 save.json.tmp,不能自动认定它比正式存档新。它可能是崩溃前写到一半的残留文件,也可能已经完整但尚未完成替换。

处理顺序应是:先验证正式存档;再验证临时文件;只有在产品明确设计了恢复策略、并且临时文件包含可比较的版本号或提交标记时,才考虑恢复临时文件。否则优先保留已确认可用的正式存档,并清理无法证明完整性的残留临时文件。

用故障注入验证回退

不要只测试“保存成功”。至少验证三个断点:写临时文件前失败、临时文件写完后失败、正式替换前失败。每次失败后重新启动,都应仍能读到上一份完整存档。

如果一次故障能让正式存档消失、JSON 截断,或让不同状态文件来自不同版本,说明保存边界仍然过大或切换点不够清晰。可靠的回退设计不是“失败后再想办法修”,而是让失败发生时,旧状态从未失去可用性。

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

目录与阅读设置

阅读设置

17

记录一个想法

失败保存后如何回退

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

登录哪都通