游戏客户端架构 / 系统课时
读档失败应该先区分哪几类问题
读档失败应该先区分哪几类问题
读档失败不能只返回一句“存档损坏”。文件根本不存在、JSON 无法解析、版本不再支持、完整性校验失败和业务字段非法,处理方式完全不同。本节建立一套分层错误模型,让程序既能给玩家合理反馈,也能为迁移、修复和日志定位保留足够信息。
学习目标
- 区分文件不存在、格式错误、版本过旧、校验失败和业务数据异常
- 按固定顺序定位失败阶段,避免把所有异常都归为“坏档”
- 为不同错误设计恢复动作、玩家提示和诊断信息
先按失败阶段分类
一个可靠的读档流程通常依次经过“找到文件、解析结构、识别版本、验证完整性、构造业务状态”。错误分类最好与这些阶段一一对应,而不是根据异常消息临时猜测原因。

这五类问题可以这样理解:文件不存在说明还没有数据可读;格式错误说明字节已经取得,但无法还原为约定的数据结构;版本过旧说明格式可识别,却不能直接交给当前代码;校验失败说明文件可能被截断、篡改或写入不完整;业务数据异常则表示结构正确,但内容违反游戏规则。
给错误一个稳定的类型
不要让上层 UI 依赖底层异常文本,例如通过判断消息里是否包含 checksum 来决定提示。异常文本会随着库、语言和实现变化,而错误类型应该保持稳定。
下面的 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));
}
}
}预期输出:
FILE_NOT_FOUND
FORMAT_ERROR
VERSION_TOO_OLD
CHECKSUM_FAILED
BUSINESS_DATA_INVALID实际项目还应在统一结果对象中保存底层异常、存档路径、schema 版本等诊断信息,但这些信息用于日志和调试,不应直接暴露给玩家。
不同错误要走不同恢复路径
错误分类的价值不在于日志更漂亮,而在于后续动作不同。文件不存在通常不是“损坏”,首次启动时甚至是正常情况;可以创建新档或提示选择其他槽位。格式错误和校验失败则应停止读取,并尽量保留原文件供恢复或分析。
版本过旧要先判断是否存在迁移链。能够迁移时进入版本升级流程,不能迁移时才明确提示该版本不再受支持。业务数据异常通常不能靠重新解析解决,应指出具体字段并拒绝把半合法状态写入运行时对象。
| 错误类型 | 是否继续读档 | 常见处理 |
|---|---|---|
| 文件不存在 | 否 | 新建存档、选择其他槽位 |
| 格式错误 | 否 | 保留原文件,提示无法解析 |
| 版本过旧 | 视迁移能力而定 | 执行迁移或提示不兼容 |
| 校验失败 | 否 | 标记疑似损坏,避免覆盖原文件 |
| 业务数据异常 | 否 | 记录非法字段,拒绝应用状态 |
排查时保持固定顺序
排查顺序应该与读取管线一致:先确认路径和文件,再解析格式,再看版本,再做完整性验证,最后检查业务规则。这样可以避免用后续错误掩盖前面的根因。例如一个无法解析的文件没有必要继续讨论角色等级是否合法。
还要避免在失败后立即自动覆盖原存档。尤其是格式错误和校验失败时,原文件可能仍有人工恢复价值。更安全的做法是保持原文件只读,将修复后的结果写入临时文件,通过完整验证后再替换正式存档。
当读档层能够稳定返回“失败发生在哪一层”,上层才能准确决定是新建、迁移、重试、恢复备份还是提示损坏;这比一个笼统的 LOAD_FAILED 更适合长期维护。