游戏引擎 / 系统课时

兼容损坏存档与旧版字段

兼容损坏存档与旧版字段

游戏启动时,存档可能被意外截断,也可能来自尚未使用新字段的旧版本。本课实现一个能识别版本、迁移旧字段、校验数据并尝试备份恢复的加载器;当所有副本都不可用时,游戏仍能进入菜单,由玩家决定是否开始新游戏。

学习目标

  • 区分文件缺失、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 字段也不代表解析失败。这里显式验证版本、关卡、生命值与检查点,不依赖反序列化后的字段初始值来判断文件是否有效。

按失败类型选择恢复路径

读取时先验证主存档,再决定是否使用备份。旧版迁移只修改内存对象,不立即重写磁盘;这样既能继续游戏,又能保留原始文件以便排查。

  1. 主文件有效:v2 直接读取;v1 或缺少版本号且满足旧版字段规则时,映射成 v2。
  2. 主文件缺失、JSON 解析失败或业务字段无效:尝试读取 .bak;备份也必须通过相同的版本与范围校验。
  3. 主文件版本大于 2:停止恢复并提示更新游戏,不擅自加载较旧备份,也不覆盖高版本文件。
  4. 两份都不可用:保留菜单入口,显示“存档不可用”,让玩家明确选择“新游戏”;此时不自动写盘。

主存档版本检查、旧字段迁移与备份回退流程

在 Unity 6 中实现加载和备份

在 Assets/Scripts 下创建 SaveRecoveryDemo.cs,将脚本挂到空物体并运行。演示只操作 Application.persistentDataPath/SaveRecoveryLessonDemo 下的测试文件,不触碰游戏正式存档。代码先将合法 v1 备份,再模拟主文件损坏、v2 缺字段及两份文件均缺失的情况。

csharp
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);
    }
}

预期输出(仅列控制台日志正文,编辑器时间戳与路径可能不同):

text
主存档不可用,已从备份载入内存(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 是否对应实际生成点,再恢复玩家与关卡对象。只有玩家主动触发保存且新数据通过校验,才应更新磁盘文件。

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

目录与阅读设置

阅读设置

17

记录一个想法

兼容损坏存档与旧版字段

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

登录哪都通