游戏客户端架构 / 系统课时

为什么不能直接覆盖正式存档

为什么不能直接覆盖正式存档

本节解决一个最容易被忽略的存档风险:如果保存时直接打开正式文件并覆盖,断电、进程崩溃或磁盘写入失败都可能同时毁掉旧存档和新存档。目标是把“保存失败”限制在临时文件里,让正式存档尽量始终保持可读取状态。

学习目标

  • 理解直接覆盖为什么会把一次写入失败放大成存档损坏
  • 区分临时文件、原子替换和备份回滚分别解决的问题
  • 能设计一个“失败时保住旧档”的基本写入边界

直接覆盖真正危险的地方

常见直觉是:把最新游戏状态序列化后,直接写回 save.json。问题在于,多数“覆盖写”会先截断原文件,再逐步写入新内容。只要中断发生在“截断完成、写入未完成”之间,旧内容已经消失,新内容又不完整。

下面的示例故意只写入一半内容,用来模拟进程在覆盖过程中突然终止:

python
from pathlib import Path
import tempfile

with tempfile.TemporaryDirectory() as directory:
    save_path = Path(directory) / "save.json"
    save_path.write_text('{"gold":100,"hp":80}', encoding="utf-8")

    # open(..., "w") 会先截断原文件,再开始写入新数据。
    with save_path.open("w", encoding="utf-8") as file:
        file.write('{"gold":900')

    print(save_path.read_text(encoding="utf-8"))

预期输出:

text
{"gold":900

这个文件已经既不是旧存档,也不是合法的新存档。即使下一次启动时有 JSON 校验,也只能发现“坏了”,无法凭空恢复被截断的旧数据。

直接覆盖时中断导致正式存档损坏的流程

中断并不只发生在写文件这一行

一次存档通常包含序列化、写入、刷新缓冲区、文件系统落盘等阶段。应用崩溃可能发生在序列化后、写到一半时,设备掉电还可能发生在系统仍有缓存尚未真正持久化时。

因此,“函数返回了”不等于“任何故障下都绝对不会丢失”。设计存档系统时更实际的目标是缩小损坏范围:新数据失败时,至少不要破坏已经验证可用的正式文件。

临时文件、替换和回滚分别做什么

三种机制解决的是不同层次的问题:

机制 主要作用 失败时的价值
临时文件 把新内容先写到旁路文件 新内容写坏时不碰正式存档
原子替换 在准备完成后一次切换新旧文件 避免读到“替换到一半”的正式文件
备份回滚 保留上一份或更早的可用版本 新正式文件后来被发现逻辑损坏时可恢复

临时文件并不是备份。它代表“尚未提交的新版本”;备份则代表“已经提交过、确认可用的历史版本”。把两者混在一起,会让启动恢复逻辑很难判断哪个文件才可信。

把失败边界缩小

更安全的基本策略是:正式文件只承担“已提交版本”,新存档先写入同目录临时文件,完成序列化与校验后再替换正式文件。如果临时写入失败,就删除或忽略临时文件,继续使用旧正式档。

如果业务还要求防御“新文件格式合法,但业务内容错误”,再额外保留一个上一版本备份。这样一次普通写入故障最多损坏临时文件,而不会把唯一可用的正式存档一起带走。

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

目录与阅读设置

阅读设置

17

记录一个想法

为什么不能直接覆盖正式存档

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

登录哪都通