游戏客户端架构 / 系统课时
原子替换如何避免半截存档
原子替换如何避免半截存档
本节把“先写临时文件”进一步做成可提交的保存流程:只有临时文件完整写入并刷新后,才用替换操作切换到正式存档。这样即使中途失败,读取端看到的通常仍是旧版本或完整的新版本,而不是半截文件。
学习目标
- 理解原子替换在存档提交阶段解决的核心问题
- 能实现“临时写入、刷新、替换”的最小保存流程
- 知道原子性、持久化和启动恢复之间的边界
原子替换的核心约束
原子替换关心的是“可见性切换”:当底层操作系统和文件系统支持同一文件系统内的原子重命名或替换时,正式路径会从旧文件直接切换到新文件,外部观察者不会看到一个逐字节变化的正式文件。
为了满足这个前提,临时文件应放在正式文件同一目录或至少同一文件系统中。不要先写到另一个磁盘分区,再用普通跨卷移动冒充原子替换,因为跨文件系统操作通常需要复制和删除,语义已经不同。

先写临时文件再切换
下面用 Python 演示最小流程。示例把临时文件放在正式文件旁边,并在替换前模拟一次失败,验证旧档仍然存在;随后再执行一次完整保存。
import json
import os
import tempfile
from pathlib import Path
def save_atomic(save_path: Path, data: dict, fail_before_replace: bool = False) -> None:
temp_path = save_path.with_suffix(save_path.suffix + ".tmp")
payload = json.dumps(data, ensure_ascii=False, separators=(",", ":"))
# 新内容只写入临时文件,正式存档此时保持不变。
with temp_path.open("w", encoding="utf-8") as file:
file.write(payload)
file.flush()
os.fsync(file.fileno())
if fail_before_replace:
raise RuntimeError("simulated interruption")
# 同一文件系统内用 replace 提交新版本。
os.replace(temp_path, save_path)
with tempfile.TemporaryDirectory() as directory:
save_path = Path(directory) / "save.json"
save_path.write_text('{"slot":1,"gold":100}', encoding="utf-8")
try:
save_atomic(save_path, {"slot": 1, "gold": 900}, fail_before_replace=True)
except RuntimeError:
pass
print("after interrupted write:", save_path.read_text(encoding="utf-8"))
save_atomic(save_path, {"slot": 1, "gold": 900})
print("after successful replace:", save_path.read_text(encoding="utf-8"))预期输出:
after interrupted write: {"slot":1,"gold":100}
after successful replace: {"slot":1,"gold":900}第一次失败发生在替换之前,所以正式文件仍是旧版本。第二次完成替换后,正式路径才切换到新内容。这个边界正是“先准备、再提交”的关键。
原子替换不等于绝对持久化
os.replace 负责的是路径层面的替换,不代表所有硬件和文件系统上的掉电持久化都自动完成。示例在替换前对临时文件执行 flush 和 fsync,是为了尽量把文件内容交给操作系统完成持久化。
对极高可靠性场景,还要研究目标平台的文件系统语义。例如某些 Unix 系统会进一步同步父目录,确保目录项变化在掉电后也被持久化;不同桌面平台、主机和移动平台的 API 与保证并不完全一致。
启动时处理遗留临时文件
即使正式文件安全,崩溃仍可能留下 save.json.tmp。启动恢复时不要看到临时文件就无条件覆盖正式档,应先判断双方是否完整、版本号是否合理、校验值是否通过。
一个稳妥的判定顺序是:正式文件有效时优先使用正式文件,并把未提交临时文件视为残留;正式文件缺失或损坏、临时文件却通过完整校验时,才考虑把临时文件提升为正式文件。若两者都无效,再进入备份恢复或新建存档流程。
什么时候还需要备份文件
原子替换只能避免“写到一半”这类物理损坏,不能阻止业务层把一份结构合法但内容错误的新存档完整提交。例如版本迁移逻辑写错,仍可能原子地替换掉好文件。
因此,可靠方案通常把职责拆开:临时文件负责安全提交,原子替换负责切换可见版本,上一版本备份负责业务级回滚。三者组合后,写入故障、提交故障和逻辑错误才有各自的恢复出口。