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

读档失败应该先区分哪几类问题

读档失败应该先区分哪几类问题

读档失败不能只返回一句“存档损坏”。文件根本不存在、JSON 无法解析、版本不再支持、完整性校验失败和业务字段非法,处理方式完全不同。本节建立一套分层错误模型,让程序既能给玩家合理反馈,也能为迁移、修复和日志定位保留足够信息。

学习目标

  • 区分文件不存在、格式错误、版本过旧、校验失败和业务数据异常
  • 按固定顺序定位失败阶段,避免把所有异常都归为“坏档”
  • 为不同错误设计恢复动作、玩家提示和诊断信息

先按失败阶段分类

一个可靠的读档流程通常依次经过“找到文件、解析结构、识别版本、验证完整性、构造业务状态”。错误分类最好与这些阶段一一对应,而不是根据异常消息临时猜测原因。

读档失败分类与处理流程

这五类问题可以这样理解:文件不存在说明还没有数据可读;格式错误说明字节已经取得,但无法还原为约定的数据结构;版本过旧说明格式可识别,却不能直接交给当前代码;校验失败说明文件可能被截断、篡改或写入不完整;业务数据异常则表示结构正确,但内容违反游戏规则。

给错误一个稳定的类型

不要让上层 UI 依赖底层异常文本,例如通过判断消息里是否包含 checksum 来决定提示。异常文本会随着库、语言和实现变化,而错误类型应该保持稳定。

下面的 Java 示例把底层异常统一映射为读档错误类型。示例重点是错误边界,因此用自定义异常代表各阶段实际抛出的异常。

java
public class SaveLoadErrorDemo {
    enum LoadError {
        FILE_NOT_FOUND,
        FORMAT_ERROR,
        VERSION_TOO_OLD,
        CHECKSUM_FAILED,
        BUSINESS_DATA_INVALID,
        UNKNOWN
    }

    static class FormatException extends Exception {}
    static class OldVersionException extends Exception {}
    static class ChecksumException extends Exception {}
    static class BusinessDataException extends Exception {}

    static LoadError classify(Exception error) {
        if (error instanceof java.io.FileNotFoundException) {
            return LoadError.FILE_NOT_FOUND;
        }
        if (error instanceof FormatException) {
            return LoadError.FORMAT_ERROR;
        }
        if (error instanceof OldVersionException) {
            return LoadError.VERSION_TOO_OLD;
        }
        if (error instanceof ChecksumException) {
            return LoadError.CHECKSUM_FAILED;
        }
        if (error instanceof BusinessDataException) {
            return LoadError.BUSINESS_DATA_INVALID;
        }
        return LoadError.UNKNOWN;
    }

    public static void main(String[] args) {
        Exception[] errors = {
            new java.io.FileNotFoundException(),
            new FormatException(),
            new OldVersionException(),
            new ChecksumException(),
            new BusinessDataException()
        };

        for (Exception error : errors) {
            System.out.println(classify(error));
        }
    }
}

预期输出:

text
FILE_NOT_FOUND
FORMAT_ERROR
VERSION_TOO_OLD
CHECKSUM_FAILED
BUSINESS_DATA_INVALID

实际项目还应在统一结果对象中保存底层异常、存档路径、schema 版本等诊断信息,但这些信息用于日志和调试,不应直接暴露给玩家。

不同错误要走不同恢复路径

错误分类的价值不在于日志更漂亮,而在于后续动作不同。文件不存在通常不是“损坏”,首次启动时甚至是正常情况;可以创建新档或提示选择其他槽位。格式错误和校验失败则应停止读取,并尽量保留原文件供恢复或分析。

版本过旧要先判断是否存在迁移链。能够迁移时进入版本升级流程,不能迁移时才明确提示该版本不再受支持。业务数据异常通常不能靠重新解析解决,应指出具体字段并拒绝把半合法状态写入运行时对象。

错误类型 是否继续读档 常见处理
文件不存在 否 新建存档、选择其他槽位
格式错误 否 保留原文件,提示无法解析
版本过旧 视迁移能力而定 执行迁移或提示不兼容
校验失败 否 标记疑似损坏,避免覆盖原文件
业务数据异常 否 记录非法字段,拒绝应用状态

排查时保持固定顺序

排查顺序应该与读取管线一致:先确认路径和文件,再解析格式,再看版本,再做完整性验证,最后检查业务规则。这样可以避免用后续错误掩盖前面的根因。例如一个无法解析的文件没有必要继续讨论角色等级是否合法。

还要避免在失败后立即自动覆盖原存档。尤其是格式错误和校验失败时,原文件可能仍有人工恢复价值。更安全的做法是保持原文件只读,将修复后的结果写入临时文件,通过完整验证后再替换正式存档。

当读档层能够稳定返回“失败发生在哪一层”,上层才能准确决定是新建、迁移、重试、恢复备份还是提示损坏;这比一个笼统的 LOAD_FAILED 更适合长期维护。

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

目录与阅读设置

阅读设置

17

记录一个想法

读档失败应该先区分哪几类问题

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

登录哪都通