游戏客户端架构 / 系统课时
怎么给存档系统写自动化测试
怎么给存档系统写自动化测试
存档系统最危险的问题往往不是“完全不能保存”,而是升级后少字段、损坏后无法恢复,或并发写入偶发产生半份文件。自动化测试应直接覆盖这些失败路径,并验证写入后的真实数据,而不是只测试某个序列化函数是否被调用。
学习目标
- 为序列化、版本迁移、损坏恢复和边界数据建立可重复测试
- 验证并发写入后文件仍然完整且可解析
- 区分适合单元测试的纯逻辑与必须进入集成测试的真实存储行为
先按风险设计测试集合
测试数量不是越多越好,优先覆盖一旦出错就会让玩家丢进度的路径。最小测试集合通常包含下面几类。
| 测试 | 核心断言 |
|---|---|
| 序列化往返 | 保存再读取后,业务数据与原值一致 |
| 版本迁移 | 旧版本能升级到当前结构且数据不丢失 |
| 文件损坏 | 主文件无法解析时能够拒绝或使用备份 |
| 并发写入 | 最终文件完整,不能出现两份 JSON 拼接或半写状态 |
| 边界数据 | 零值、大整数、Unicode、空集合等不会改变语义 |
这里应尽量把迁移、校验和编码做成不依赖 Unity、Unreal、Godot 场景对象的纯逻辑。这样绝大多数测试可以在普通测试进程里快速运行,只有真正涉及平台目录、云存档或引擎生命周期的部分再进入集成测试。
写一组能够真实失败的测试
下面用 Python 标准库构造一个最小存档核心,并用 unittest 覆盖五类风险。示例中的备份恢复、版本迁移和原子替换都是真实执行,而不是 Mock 掉文件系统。
将下面内容保存为 save_test.py:
import json
import os
import tempfile
import threading
import unittest
CURRENT_VERSION = 2
WRITE_LOCK = threading.Lock()
def encode(data):
return json.dumps(data, ensure_ascii=False, separators=(",", ":"))
def decode(text):
return json.loads(text)
def migrate(data):
# 版本 1 将 coins 直接放在根节点,版本 2 移入 wallet。
if data.get("version") == 1:
return {
"version": 2,
"wallet": {"coins": data.get("coins", 0)},
"name": data.get("name", ""),
}
if data.get("version") == CURRENT_VERSION:
return data
raise ValueError("unsupported save version")
def safe_load(primary_path, backup_path):
# 主存档损坏时再尝试备份,两份都损坏则继续抛出异常。
for path in (primary_path, backup_path):
try:
with open(path, "r", encoding="utf-8") as f:
return decode(f.read())
except (OSError, json.JSONDecodeError):
continue
raise ValueError("no valid save")
def atomic_write(path, data):
temp_path = path + ".tmp"
with WRITE_LOCK:
with open(temp_path, "w", encoding="utf-8") as f:
f.write(encode(data))
f.flush()
os.fsync(f.fileno())
os.replace(temp_path, path)
class SaveSystemTests(unittest.TestCase):
def test_round_trip(self):
original = {"version": 2, "wallet": {"coins": 37}, "name": "Ava"}
self.assertEqual(original, decode(encode(original)))
def test_migration_from_v1(self):
old = {"version": 1, "coins": 80, "name": "Ava"}
migrated = migrate(old)
self.assertEqual(2, migrated["version"])
self.assertEqual(80, migrated["wallet"]["coins"])
def test_corrupted_primary_uses_backup(self):
with tempfile.TemporaryDirectory() as d:
primary = os.path.join(d, "save.json")
backup = os.path.join(d, "save.bak")
with open(primary, "w", encoding="utf-8") as f:
f.write("{broken")
with open(backup, "w", encoding="utf-8") as f:
f.write(encode({"version": 2, "wallet": {"coins": 9}}))
self.assertEqual(9, safe_load(primary, backup)["wallet"]["coins"])
def test_concurrent_writes_remain_valid(self):
with tempfile.TemporaryDirectory() as d:
path = os.path.join(d, "save.json")
workers = [
threading.Thread(target=atomic_write, args=(path, {"version": 2, "value": value}))
for value in (1, 2)
]
for worker in workers:
worker.start()
for worker in workers:
worker.join()
with open(path, "r", encoding="utf-8") as f:
result = decode(f.read())
self.assertIn(result["value"], (1, 2))
def test_boundary_data(self):
original = {
"version": 2,
"wallet": {"coins": 2**63 - 1},
"name": "玩家Ω",
"items": [],
}
self.assertEqual(original, decode(encode(original)))
if __name__ == "__main__":
unittest.main(verbosity=2)在保存文件的目录执行:
python save_test.py预期输出的测试顺序可能因运行环境略有差异,耗时也会不同:
test_boundary_data ... ok
test_concurrent_writes_remain_valid ... ok
test_corrupted_primary_uses_backup ... ok
test_migration_from_v1 ... ok
test_round_trip ... ok
Ran 5 tests in <TIME>s
OK这组测试有一个重要特点:断言检查的是最终存档语义和磁盘结果。如果把 atomic_write 改成可能产生部分写入的实现,或者删除迁移中的金币字段,测试就应该失败。
迁移测试要保留历史样本
迁移系统最常见的盲点,是只测试“当前版本到当前版本”。真正上线后,玩家可能从数月前甚至更早的版本直接升级,因此测试目录应该保留具有代表性的历史存档样本。
例如当前版本为 5,就至少验证仍受支持的版本能够沿迁移链到达版本 5,并对重要业务字段做断言。不要只检查最后的 version 数字,因为一个错误迁移完全可能把版本号改对,却把任务进度、物品数量或角色属性丢掉。
并发与损坏测试不能只靠 Mock
Mock 文件系统适合验证调用关系,却无法证明 flush、替换文件、备份恢复或两个写入线程之间的行为正确。至少应有一层测试使用临时目录执行真实磁盘操作,并在写入结束后重新打开文件解析。
并发测试的断言也不是“最后一定是谁写赢”。如果系统定义的是后写覆盖,那么调度顺序可能由运行环境决定;真正稳定的断言应是最终内容属于某个完整提交,并且文件始终能够被解析。如果业务要求严格的先后顺序,则应另外引入序列号、队列或事务规则,再测试那项明确约束。
把引擎测试留给边界
纯数据测试通过后,还需要少量引擎级集成测试验证适配层。例如创建一个最小场景,修改玩家状态,触发保存,销毁或重建运行时对象,再执行读档并检查最终状态。Unity、Unreal 和 Godot 的测试框架不同,但应共享同一组业务验收条件。
测试分层的重点不是追求百分之百覆盖率,而是让风险最低成本地被发现:序列化和迁移尽量在快速单元测试中完成,真实文件行为进入临时目录测试,引擎对象恢复和平台存储只保留少量集成测试。这样每次修改存档模型或迁移代码时,都能在玩家真正丢档之前发现问题。