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

怎么给存档系统写自动化测试

怎么给存档系统写自动化测试

存档系统最危险的问题往往不是“完全不能保存”,而是升级后少字段、损坏后无法恢复,或并发写入偶发产生半份文件。自动化测试应直接覆盖这些失败路径,并验证写入后的真实数据,而不是只测试某个序列化函数是否被调用。

学习目标

  • 为序列化、版本迁移、损坏恢复和边界数据建立可重复测试
  • 验证并发写入后文件仍然完整且可解析
  • 区分适合单元测试的纯逻辑与必须进入集成测试的真实存储行为

先按风险设计测试集合

测试数量不是越多越好,优先覆盖一旦出错就会让玩家丢进度的路径。最小测试集合通常包含下面几类。

测试 核心断言
序列化往返 保存再读取后,业务数据与原值一致
版本迁移 旧版本能升级到当前结构且数据不丢失
文件损坏 主文件无法解析时能够拒绝或使用备份
并发写入 最终文件完整,不能出现两份 JSON 拼接或半写状态
边界数据 零值、大整数、Unicode、空集合等不会改变语义

这里应尽量把迁移、校验和编码做成不依赖 Unity、Unreal、Godot 场景对象的纯逻辑。这样绝大多数测试可以在普通测试进程里快速运行,只有真正涉及平台目录、云存档或引擎生命周期的部分再进入集成测试。

写一组能够真实失败的测试

下面用 Python 标准库构造一个最小存档核心,并用 unittest 覆盖五类风险。示例中的备份恢复、版本迁移和原子替换都是真实执行,而不是 Mock 掉文件系统。

将下面内容保存为 save_test.py:

python
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)

在保存文件的目录执行:

bash
python save_test.py

预期输出的测试顺序可能因运行环境略有差异,耗时也会不同:

text
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 的测试框架不同,但应共享同一组业务验收条件。

测试分层的重点不是追求百分之百覆盖率,而是让风险最低成本地被发现:序列化和迁移尽量在快速单元测试中完成,真实文件行为进入临时目录测试,引擎对象恢复和平台存储只保留少量集成测试。这样每次修改存档模型或迁移代码时,都能在玩家真正丢档之前发现问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

怎么给存档系统写自动化测试

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

登录哪都通