存档系统设计:数据模型、序列化、版本迁移、安全写入、加密与云存档

2112 字
11 分钟
存档系统设计:数据模型、序列化、版本迁移、安全写入、加密与云存档

一、存档数据与运行时对象分离#

不要直接序列化游戏中的运行时对象(MonoBehaviour、各种管理器)。它们包含大量不需要保存的状态、对 Unity 对象的引用,结构也会随着开发不断变化。

应该定义一套专门的存档数据结构:

[Serializable]
public class SaveData
{
public int Version = 3; // 存档版本号
public long SaveTime;
public PlayerSave Player = new();
public List<ItemSave> Items = new();
public Dictionary<int, int> LevelStars = new(); // 用支持 Dictionary 的序列化库
}
[Serializable]
public class PlayerSave
{
public int Level;
public long Gold;
public int[] UnlockedSkills;
}
  • 只包含需要保存的纯数据:数字、字符串、ID;
  • 引用其他对象时保存它的 ID,而不是对象本身(物品保存配置 ID,见 背包的配置与实例);
  • 保存时从运行时数据生成存档数据,读取时根据存档数据重建运行时状态。

二、序列化格式#

格式优点缺点
JSON可读,便于调试;修改结构时容错性好体积较大;Unity 的 JsonUtility 不支持 Dictionary 和多态(见 序列化规则),通常改用 Newtonsoft.Json
二进制(Protobuf、MessagePack 等)体积小、读写快不可读,需要工具查看
BinaryFormatter—不要使用:有严重的安全隐患,.NET 官方已经弃用

格式的原理和对比见 序列化与网络协议。

单机休闲游戏用 JSON 完全足够;数据量大、保存频繁时考虑二进制。

三、版本与迁移#

游戏会不断更新,存档的结构也会变:新增字段、修改字段的含义、拆分数据。旧版本的存档必须能被新版本正确读取,否则玩家更新后进度丢失,是最严重的事故之一。

每份存档带上版本号,读取时逐步升级:

SaveData Load(string json)
{
var raw = JObject.Parse(json);
int version = raw.Value<int>("Version");
if (version < 2) MigrateV1ToV2(raw); // v1 → v2:金币从 int 改成了 long
if (version < 3) MigrateV2ToV3(raw); // v2 → v3:背包结构调整
raw["Version"] = CurrentVersion;
return raw.ToObject<SaveData>();
}
  • 每一个版本的变化写一个迁移函数,按顺序依次执行,任何旧版本都能升级到最新;
  • 新增字段要有合理的默认值;
  • 删除字段前先确认迁移已经处理了它的数据;
  • 保留一些各个版本的真实存档作为测试用例,每次发版前验证都能正确读取。

四、安全地写入#

问题:写入存档的过程中,游戏崩溃、手机没电、进程被杀,文件只写了一半,存档就损坏了。

先写临时文件,再替换:

public static void SafeWrite(string path, byte[] data)
{
string tmp = path + ".tmp";
string backup = path + ".bak";
File.WriteAllBytes(tmp, data); // 1. 完整写入临时文件
if (File.Exists(path))
File.Replace(tmp, path, backup); // 2. 用临时文件替换正式文件,旧文件留作备份
else
File.Move(tmp, path);
}
  • 写临时文件时崩溃:正式存档完好无损;
  • 替换是很快的文件系统操作,几乎不会中途失败;
  • 个别平台的文件系统可能不支持 File.Replace,可以改为”删除正式文件、再把临时文件移动过去”,并在启动时检查是否残留了未完成替换的临时文件;
  • 保留上一个版本的备份,读取正式存档失败(校验不通过、解析出错)时,可以回退到备份。

读取时也要做好防御:文件不存在、解析失败、数据明显不合法时,使用备份或给出提示,不能直接崩溃,更不能用空数据覆盖掉原存档。

五、保存的时机#

  • 关键节点:通关、获得重要道具、完成充值后立即保存;
  • 定时自动保存:比如每隔一段时间,且只在数据有变化时(脏标记)才保存;
  • 切到后台时保存:移动端在 OnApplicationPause(true) 中保存,因为切到后台后进程随时可能被杀死,OnApplicationQuit 不一定会被调用(见 移动端的前后台切换)。

异步保存#

存档较大时,序列化和写文件可能造成一帧卡顿:

主线程:把当前的数据复制成一份快照(或者直接序列化成字节)
后台线程:写入文件

关键是写文件期间,主线程继续修改数据不能影响正在写入的那一份,所以要先做快照。同时要避免两次保存同时进行,或者后发起的保存被先发起的覆盖。

六、PlayerPrefs#

PlayerPrefs 适合保存少量的设置项:音量、画质、语言、是否看过某个提示。

不适合保存游戏进度:

  • 只支持 int、float、string 三种类型;
  • 存储的位置因平台而异(Windows 上在注册表中),容量和性能不适合大量数据;
  • 很容易被找到和修改。

七、加密与防篡改#

单机游戏的存档保存在玩家的设备上,玩家可以修改它(改金币、解锁关卡)。

手段作用
加密(如 AES)存档不再是明文,不能直接用文本编辑器修改
校验(如 HMAC 或带密钥的哈希)存档被改动后校验不通过,可以识别出来
混淆字段、分散存储增加分析的难度

局限:密钥必须放在客户端中才能解密,有经验的人可以从程序中把它找出来。所以客户端加密只是提高门槛,挡住普通玩家用工具随手修改,不能真正防住破解。

真正重要的数据必须由服务器保存和校验:付费货币、排行榜成绩、会影响其他玩家的数据。

八、云存档#

玩家换手机或者在多台设备上玩时,需要云存档。最大的问题是冲突:

手机 A 离线玩了一段时间,进度:第 30 关
手机 B 同时也在玩,已经上传到云端:第 25 关,但多了一个付费角色
两者都要上传,以谁为准?
策略做法问题
以最新的时间为准比较保存时间设备时间可能不准,也可能丢失另一边的进度
以进度更多的为准比较关卡、等级等不一定能定义”更多”
让玩家选择显示两份存档的摘要(等级、关卡、时间),让玩家决定最安全,常见做法
合并按字段合并(取最高的关卡、合并已解锁的内容)实现复杂,但体验最好

此外:

  • 存档带上版本计数,每次上传都基于上一次同步的版本,检测到云端已经被其他设备更新过,才进入冲突处理;
  • 付费相关的数据不能只依赖存档,要以服务器的购买记录为准,避免玩家因为选错存档而丢失付费内容;
  • 上传失败时保留本地数据,网络恢复后重试。

常见追问#

存档系统怎么设计? 定义独立的存档数据结构,只包含纯数据和 ID;选择合适的序列化格式;带版本号支持迁移;用临时文件加替换的方式安全写入;在关键节点、定时和切后台时保存。

为什么不直接序列化运行时对象? 运行时对象包含大量不需要保存的状态和引用,结构经常变化,耦合太紧,难以兼容旧版本的存档。

更新版本后怎么兼容旧存档? 存档带版本号,为每个版本的结构变化写迁移函数,读取时依次升级到最新版本;新字段提供默认值;用旧存档做回归测试。

怎么防止写入时崩溃导致存档损坏? 先写入临时文件,完成后再替换正式文件,并保留备份;读取失败时回退到备份。

移动端什么时候保存? 关键节点立即保存,定时自动保存,切到后台时(OnApplicationPause)一定要保存。

存档加密有用吗? 能挡住普通玩家用工具随手修改,但密钥在客户端,不能真正防破解。重要数据必须由服务器保存和校验。

云存档的冲突怎么处理? 用版本计数检测冲突,常见做法是展示两份存档的摘要让玩家选择,或者按字段合并;付费内容以服务器记录为准。

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

存档系统设计:数据模型、序列化、版本迁移、安全写入、加密与云存档
https://xslab.cloud/posts/design/save-system/
作者
LuxFire
发布于
2026-10-14
许可协议
CC BY-NC-SA 4.0
相关文章 智能推荐
1
背包与物品系统设计:配置与实例、数据结构、堆叠、整理与同步
项目设计/业务系统 物品的配置与实例如何分离;可堆叠物品与带属性的独立物品;背包的数据结构选择;添加、移除、移动、拆分、整理等操作的规则与边界情况;变化通知与界面刷新;与服务器的同步;以及背包界面的实现要点。
2
任务与成就系统设计:条件配置、事件驱动的进度统计、状态流转与重置
项目设计/业务系统 任务的类型与配置结构;把完成条件抽象成可配置的条件类型;用事件驱动进度更新以及按事件类型建立索引;任务的状态流转;每日、每周任务的重置;成就的累计统计、分级与补发;以及与服务器、红点的配合。
3
抽卡与保底设计:概率表、硬保底与软保底、期望计算与实现
项目设计/业务系统 抽卡系统的概率表结构;硬保底、软保底、十连保底、UP 保底(大小保底)的规则与实现;保底计数的保存与继承;有保底时的期望抽数计算;服务器权威、概率公示与日志审计;以及抽卡表现的设计。
4
技能与 Buff 系统设计:属性、技能、效果、Buff 的拆分与数据驱动
项目设计/业务系统 技能系统的整体结构;属性系统与修改器的计算顺序;技能的释放流程、时间轴与目标选择;把技能拆成可复用的原子效果;Buff 的生命周期、叠加规则与事件触发;伤害计算的流程;数据驱动与技能编辑器;以及联网游戏中的权威与表现。
5
序列化与网络协议:JSON、SFSObject、Protobuf、FlatBuffers 的原理与对比
项目设计/架构 序列化解决什么问题,文本格式与二进制格式的差异;SmartFoxServer 的 SFSObject 这类"自描述"格式的原理;Protobuf 的字段编号、Varint、ZigZag 编码和向前向后兼容;为什么 Protobuf 比自描述格式更小更快;MessagePack 与 FlatBuffers;以及在 Unity 中使用时的 GC 与 IL2CPP 注意事项。
随机文章 随机推荐
Profile Image of the Author
LuxFire
Hello, I'm LuxFire.
公告
欢迎来到我的博客!这是一则示例公告。
音乐
封面

音乐

暂未播放

0:00 0:00
暂无歌词
分类
标签
站点统计
文章
60
分类
6
标签
164
总字数
171,869
运行时长
0 天
最后活动
0 天前

文章目录