游戏客户端架构 / 系统课时
上线前检查哪些存档风险
上线前检查哪些存档风险
存档功能上线前不能只确认“能存能读”,还要检查版本升级后是否能继续加载、备份是否真的可恢复、日志能否定位故障、各平台路径是否正确,以及新版本出现问题时能否回滚。把这些风险显式化,才能避免小概率问题演变成大面积坏档。
学习目标
- 建立覆盖兼容、恢复、日志、平台路径和回滚能力的上线检查表
- 区分必须阻止发布的风险与可以上线后继续观察的风险
- 用可版本化的存档策略文件固定关键约束,减少口头约定
把存档契约写成可检查配置
上线检查最容易遗漏的是“大家都知道但没人写下来”的约定,例如当前存档版本、最低兼容版本、备份数量和是否允许自动迁移。可以把这些约束写进版本库中的策略文件,让代码评审和发布检查都有明确依据。
{
"currentSaveVersion": 5,
"minimumReadableVersion": 3,
"backupCount": 2,
"atomicReplaceRequired": true,
"autoMigrationEnabled": true,
"preserveBrokenFiles": true
}这段配置的生效行为应由项目自己的存档模块读取或由构建脚本校验;不要为了“通用”而设计一套并不存在的运行时参数。验证时至少确认:当前版本大于等于最低可读版本、备份数不小于 1,并且生产构建没有关闭原子替换与坏档保留策略。
逐项检查发布阻断风险
版本兼容是第一道门。发布包至少要用最近几个正式版本产生的真实存档做回归,验证字段新增、重命名、枚举变化和数值范围调整。若某个旧版本不能迁移,必须明确最低支持版本和用户可见处理方式,不能让解析器在未知结构上继续运行。
数据恢复要验证“备份存在”之外的事情:备份是什么时机产生、最多保留几份、恢复时按什么优先级选择、坏备份会不会被再次覆盖。主存档损坏后至少应有一个独立恢复路径;如果没有,就应把该风险视为发布阻断项。
日志要能回答三个问题:哪个存档槽位失败、失败发生在哪个阶段、当时读取的存档版本是多少。日志里不应直接写完整存档正文、认证令牌或其他敏感信息。错误日志只有“load failed”而没有阶段和版本时,线上几乎无法定位。
平台路径必须在目标平台真机验证。Windows、macOS、Linux、Android、iOS 对应用数据目录、权限和生命周期的约束不同,测试时应通过平台提供的应用数据目录 API 获取路径,而不是硬编码用户目录。尤其要检查升级安装后路径是否稳定、卸载重装后的预期行为是否与产品设计一致。
明确回滚到底能回什么
程序版本能回滚,不代表存档一定能回滚。假设新版本把存档从版本 4 迁移到版本 5,而旧客户端只认识版本 4,那么应用回滚后可能反而打不开已经升级的存档。
因此上线前要明确迁移策略:迁移前是否保留旧格式备份,迁移是否只执行一次,迁移失败是否会回到原文件,以及旧客户端是否有机会再次打开该存档。若格式升级不可逆,就不要把“回滚安装包”当成完整回滚方案。
用检查表做最后一次发布门禁
发布前可以按下面的最小清单逐项签字。表格的价值在于明确“是否验证过”,而不是替代测试报告。
| 检查项 | 通过条件 | 未通过时处理 |
|---|---|---|
| 版本兼容 | 支持范围内的历史存档全部可读或可迁移 | 阻止发布 |
| 损坏恢复 | 主存档损坏时可从独立备份恢复 | 阻止发布 |
| 坏备份处理 | 主备份都坏时停止覆盖并保留现场 | 阻止发布 |
| 日志记录 | 能定位槽位、阶段、版本与错误类型 | 高优先级修复 |
| 平台路径 | 每个目标平台均使用受支持的数据目录 | 阻止对应平台发布 |
| 回滚能力 | 明确程序回滚与存档格式回滚边界 | 阻止高风险迁移发布 |
对于低概率但后果严重的项,判断标准不应是“以前没出过问题”,而应是“出问题后能否恢复”。存档系统承载的是用户长期进度,一次不可恢复的坏档往往比一次普通功能崩溃更严重。
发布后仍要保留可观测性
上线后至少持续观察存档加载失败率、迁移失败率和备份恢复触发次数。指标异常时,应能按客户端版本和存档版本分组,快速判断是新版本代码问题还是历史数据问题。
上线前的检查目标不是证明系统永远不会失败,而是确认失败模式已经被识别、恢复路径经过验证、日志足够定位,并且最坏情况下仍有可执行的回退方案。做到这些,存档方案才具备长期演进的基础。