游戏引擎 / 系统课时
兼容损坏存档与旧版字段
兼容损坏存档与旧版字段
游戏启动时,存档可能被意外截断,也可能来自尚未使用新字段的旧版本。本课实现一个能识别版本、迁移旧字段、校验数据并尝试备份恢复的加载器;当所有副本都不可用时,游戏仍能进入菜单,由玩家决定是否开始新游戏。
学习目标
- 区分文件缺失、JSON 无法解析、字段非法和存档版本过新。
- 将旧版
health迁移为hp,为缺失的检查点提供明确默认值。 - 按主存档、备份、新游戏的顺序恢复,并避免自动覆盖异常文件。
给存档定义可检查的兼容规则
示例关卡为 Arena01,生命值允许 1~100,检查点只接受 Spawn_00 和 CP_01。存档使用 Unity 6 的 JsonUtility,字段必须是可序列化类中的字段,而不是只读属性。
| 检查项 | 旧版 v1 | 当前 v2 | 处理规则 |
|---|---|---|---|
| 版本号 | version 为 1 或缺失(读出为 0) |
version=2 |
大于 2 的版本提示更新游戏,禁止覆盖 |
| 生命值 | health |
hp |
旧值复制到新字段;缺失或超出 1~100 则拒绝 |
| 关卡 | sceneId |
sceneId |
本演示只允许 Arena01 |
| 检查点 | 无 | checkpointId |
缺失或空字符串时补 Spawn_00;未知 ID 拒绝 |
JsonUtility.FromJson<T>() 不会替你判断业务字段是否齐全;不认识的 JSON 字段也不代表解析失败。这里显式验证版本、关卡、生命值与检查点,不依赖反序列化后的字段初始值来判断文件是否有效。
按失败类型选择恢复路径
读取时先验证主存档,再决定是否使用备份。旧版迁移只修改内存对象,不立即重写磁盘;这样既能继续游戏,又能保留原始文件以便排查。
- 主文件有效:v2 直接读取;v1 或缺少版本号且满足旧版字段规则时,映射成 v2。
- 主文件缺失、JSON 解析失败或业务字段无效:尝试读取
.bak;备份也必须通过相同的版本与范围校验。 - 主文件版本大于
2:停止恢复并提示更新游戏,不擅自加载较旧备份,也不覆盖高版本文件。 - 两份都不可用:保留菜单入口,显示“存档不可用”,让玩家明确选择“新游戏”;此时不自动写盘。

在 Unity 6 中实现加载和备份
在 Assets/Scripts 下创建 SaveRecoveryDemo.cs,将脚本挂到空物体并运行。演示只操作 Application.persistentDataPath/SaveRecoveryLessonDemo 下的测试文件,不触碰游戏正式存档。代码先将合法 v1 备份,再模拟主文件损坏、v2 缺字段及两份文件均缺失的情况。
using System;
using System.IO;
using System.Text;
using UnityEngine;
[Serializable]
public class SaveHeader { public int version; }
[Serializable]
public class SaveV1
{
public int version;
public string sceneId;
public int health;
}
[Serializable]
public class SaveV2
{
public int version;
public string sceneId;
public int hp;
public string checkpointId;
}
public class SaveRecoveryDemo : MonoBehaviour
{
void Start()
{
try
{
string dir = Path.Combine(Application.persistentDataPath, "SaveRecoveryLessonDemo");
Directory.CreateDirectory(dir);
string main = Path.Combine(dir, "slot.json");
string backup = main + ".bak";
// 写入合法旧档;下一次保存时只备份通过校验的主文件。
File.WriteAllText(main, "{\"version\":1,\"sceneId\":\"Arena01\",\"health\":70}");
SaveWithBackup(main, backup, new SaveV2 {
version = 2, sceneId = "Arena01", hp = 90, checkpointId = "CP_01"
});
File.WriteAllText(main, "{\"version\":2,"); // 模拟写入中断
PrintLoad(main, backup);
File.WriteAllText(main, "{\"version\":2,\"sceneId\":\"Arena01\",\"hp\":60}");
PrintLoad(main, backup);
File.Delete(main);
File.Delete(backup);
PrintLoad(main, backup);
}
catch (Exception ex)
{
Debug.LogError("演示无法完成:" + ex.GetType().Name);
}
}
static void PrintLoad(string main, string backup)
{
SaveV2 data = Load(main, backup, out string message);
Debug.Log(data == null ? message :
$"{message} | scene={data.sceneId} hp={data.hp} checkpoint={data.checkpointId}");
}
static SaveV2 Load(string main, string backup, out string message)
{
if (TryRead(main, out SaveV2 data, out string note, out bool newer))
{
message = "主存档读取成功(" + note + ")";
return data;
}
if (newer)
{
message = "主存档版本过新,请更新游戏(未写盘)";
return null;
}
if (TryRead(backup, out data, out note, out bool backupNewer))
{
message = "主存档不可用,已从备份载入内存(" + note + ")";
return data;
}
message = backupNewer
? "备份版本过新,请更新游戏(未写盘)"
: "主存档与备份均不可用,请选择新游戏(未写盘)";
return null;
}
static bool TryRead(string path, out SaveV2 data, out string note, out bool newer)
{
data = null;
note = "";
newer = false;
if (!File.Exists(path)) { note = "文件缺失"; return false; }
try
{
string json = File.ReadAllText(path, Encoding.UTF8);
if (string.IsNullOrWhiteSpace(json)) { note = "空文件"; return false; }
SaveHeader header = JsonUtility.FromJson<SaveHeader>(json);
if (header == null) { note = "JSON 无效"; return false; }
if (header.version > 2) { newer = true; note = "版本过新"; return false; }
if (header.version == 0 || header.version == 1)
{
SaveV1 old = JsonUtility.FromJson<SaveV1>(json);
if (old == null || old.sceneId != "Arena01" ||
old.health < 1 || old.health > 100)
{ note = "旧字段无效"; return false; }
data = new SaveV2 {
version = 2, sceneId = old.sceneId,
hp = old.health, checkpointId = "Spawn_00"
};
note = "v1 已迁移";
return true;
}
if (header.version != 2) { note = "版本无效"; return false; }
SaveV2 current = JsonUtility.FromJson<SaveV2>(json);
if (current == null || current.sceneId != "Arena01" ||
current.hp < 1 || current.hp > 100)
{ note = "当前字段无效"; return false; }
bool missing = string.IsNullOrEmpty(current.checkpointId);
if (missing) current.checkpointId = "Spawn_00";
if (current.checkpointId != "Spawn_00" && current.checkpointId != "CP_01")
{ note = "检查点不存在"; return false; }
data = current;
note = missing ? "v2 已补齐默认检查点" : "v2 有效";
return true;
}
catch (Exception)
{
note = "JSON 解析或文件读取失败";
return false;
}
}
static void SaveWithBackup(string main, string backup, SaveV2 data)
{
string temp = main + ".tmp";
File.WriteAllText(temp, JsonUtility.ToJson(data, true), Encoding.UTF8);
if (!TryRead(temp, out _, out _, out _))
throw new InvalidDataException("临时存档未通过校验");
// 只用有效旧档更新备份;坏档不能覆盖已有的好备份。
if (File.Exists(main))
{
if (TryRead(main, out _, out _, out bool newer))
File.Copy(main, backup, true);
else if (newer)
throw new InvalidOperationException("禁止覆盖更高版本存档");
}
File.Copy(temp, main, true);
File.Delete(temp);
}
}预期输出(仅列控制台日志正文,编辑器时间戳与路径可能不同):
主存档不可用,已从备份载入内存(v1 已迁移) | scene=Arena01 hp=70 checkpoint=Spawn_00
主存档读取成功(v2 已补齐默认检查点) | scene=Arena01 hp=60 checkpoint=Spawn_00
主存档与备份均不可用,请选择新游戏(未写盘)接入正式菜单时验证边界
将 Load 的返回值交给菜单控制器:非空时允许“继续游戏”,备份恢复时提示“已使用备份,建议重新保存”;返回空值时禁用继续按钮,根据提示显示“更新游戏”或“新游戏”。玩家确认新游戏后,再创建 version=2、hp=100、sceneId=Arena01、checkpointId=Spawn_00 的对象。
| 人工测试 | 必须观察到的结果 |
|---|---|
主档为 {} |
不会凭空生成有效生命值,转查备份 |
主档为 version=3 |
提示更新,主档与备份都不被修改 |
旧档 health=70 |
内存中得到 hp=70、version=2 |
v2 缺少 checkpointId |
补成 Spawn_00,其余有效字段不变 |
| 主档截断、备份有效 | 使用备份继续,损坏文件保留原样 |
恢复成功后应先检查 sceneId 是否在可加载场景清单、checkpointId 是否对应实际生成点,再恢复玩家与关卡对象。只有玩家主动触发保存且新数据通过校验,才应更新磁盘文件。