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

如何判断存档文件已经损坏

如何判断存档文件已经损坏

存档能被读取并不等于数据一定可靠。本节建立一套从文件长度、格式头、校验和到关键业务字段的分层检查方法,让读档系统在真正使用数据之前发现截断、篡改和语义异常,并给出可执行的 Java 校验示例。

学习目标

  • 理解为什么不能只靠 JSON 或二进制格式能否解析来判断存档是否完整
  • 使用长度、格式、校验和与关键字段组成分层校验链
  • 区分文件损坏、版本不兼容和业务数据异常,避免错误覆盖正常存档

损坏判断要分成多个层次

一个可靠的读档流程不应直接把文件反序列化成游戏对象。更稳妥的顺序是先判断文件结构,再验证内容完整性,最后检查业务字段是否合理。

常见的四层检查如下:

  1. 长度检查:确认文件至少包含完整文件头,并且声明的数据长度与实际长度一致。它主要发现写入中断、文件截断和错误拼接。
  2. 格式检查:检查 magic、版本号或固定结构,确认当前文件确实属于自己的存档格式。
  3. 校验和检查:对实际负载重新计算 CRC32、SHA-256 等摘要,与写入时保存的结果比较,发现内容被修改或部分字节损坏。
  4. 关键字段检查:确认角色 ID、等级、生命值、地图标识等必需数据存在,并满足合理范围。

存档损坏的分层检测流程

这几层解决的问题并不相同。例如一个格式完全正确的文件,仍然可能因为磁盘损坏导致某几个字节变化;而一个校验和完全匹配的文件,也可能保存了 level=-3 这种业务上不可能出现的数据。

用长度与校验和发现物理损坏

下面定义一个简单二进制存档格式。文件头包含四字节 magic、版本号、负载长度和 CRC32,负载使用 UTF-8 的键值文本。示例只依赖 JDK 标准库,可以直接运行。

java
import java.io.StringReader;
import java.nio.ByteBuffer;
import java.nio.charset.StandardCharsets;
import java.util.Arrays;
import java.util.Properties;
import java.util.zip.CRC32;

public class SaveIntegrityDemo {
    private static final byte[] MAGIC = {'S', 'A', 'V', 'E'};
    private static final int VERSION = 1;
    private static final int HEADER_SIZE = 4 + 4 + 4 + 8;

    public static void main(String[] args) throws Exception {
        byte[] valid = createSave("playerId=p-1001\nlevel=12\nhp=87\n");
        System.out.println(validate(valid));

        byte[] corrupted = valid.clone();
        corrupted[corrupted.length - 1] ^= 0x01; // 模拟文件中的一个字节发生变化
        System.out.println(validate(corrupted));
    }

    static byte[] createSave(String payloadText) {
        byte[] payload = payloadText.getBytes(StandardCharsets.UTF_8);
        CRC32 crc32 = new CRC32();
        crc32.update(payload);

        ByteBuffer buffer = ByteBuffer.allocate(HEADER_SIZE + payload.length);
        buffer.put(MAGIC);
        buffer.putInt(VERSION);
        buffer.putInt(payload.length);
        buffer.putLong(crc32.getValue());
        buffer.put(payload);
        return buffer.array();
    }

    static String validate(byte[] file) throws Exception {
        if (file.length < HEADER_SIZE) {
            return "CORRUPTED: header truncated";
        }

        ByteBuffer buffer = ByteBuffer.wrap(file);
        byte[] magic = new byte[4];
        buffer.get(magic);
        if (!Arrays.equals(magic, MAGIC)) {
            return "CORRUPTED: invalid format";
        }

        int version = buffer.getInt();
        if (version != VERSION) {
            return "UNSUPPORTED: version=" + version;
        }

        int payloadLength = buffer.getInt();
        long storedChecksum = buffer.getLong();
        if (payloadLength < 0 || file.length != HEADER_SIZE + payloadLength) {
            return "CORRUPTED: invalid length";
        }

        byte[] payload = new byte[payloadLength];
        buffer.get(payload);
        CRC32 crc32 = new CRC32();
        crc32.update(payload);
        if (crc32.getValue() != storedChecksum) {
            return "CORRUPTED: checksum mismatch";
        }

        Properties properties = new Properties();
        properties.load(new StringReader(new String(payload, StandardCharsets.UTF_8)));
        String playerId = properties.getProperty("playerId");
        int level = Integer.parseInt(properties.getProperty("level", "-1"));
        int hp = Integer.parseInt(properties.getProperty("hp", "-1"));

        // 文件完整并不代表业务状态有效,因此最后检查关键字段范围。
        if (playerId == null || playerId.isBlank() || level < 1 || hp < 0 || hp > 100) {
            return "CORRUPTED: invalid required fields";
        }
        return "VALID";
    }
}

预期输出:

text
VALID
CORRUPTED: checksum mismatch

CRC32 很适合发现随机损坏,计算成本也低,但它不是防恶意篡改的安全机制。如果游戏需要抵抗主动修改,应改用带密钥的 MAC 或签名机制,并把密钥管理问题单独设计,而不是把 CRC32 当成防作弊方案。

格式错误不一定等于文件损坏

校验系统最好返回明确的失败类别,而不是统一抛出“存档损坏”。尤其是版本号不匹配时,文件本身可能完全正常,只是当前客户端不知道如何读取它。

例如可以把结果至少区分为 VALID、CORRUPTED、UNSUPPORTED_VERSION 和 INVALID_CONTENT。这样上层恢复逻辑才能决定下一步是加载备份、执行版本迁移,还是直接提示用户当前客户端版本过旧。

关键字段检查也应以真正影响恢复的数据为主。角色 ID 缺失、数组数量超过允许上限、坐标出现 NaN 等通常值得拒绝;某个非关键统计字段缺失,则可以通过默认值兼容。检查过严会让旧版本正常存档无法升级,检查过松又会把异常状态带进运行时。

在真正恢复游戏状态之前完成验证

完整读档顺序应保持“先验证、后应用”。先读取原始字节并完成结构、校验和和业务约束检查,全部通过后才创建或修改运行中的角色、任务和场景状态。

如果在验证过程中就逐步修改游戏对象,一旦后半段发现损坏,系统还需要回滚已经应用的数据,异常路径会明显复杂。把验证阶段设计成只读操作,则失败时可以直接停止,并安全地切换到备份存档。

最终验收时至少准备正常文件、被截断文件、随机修改一个字节的文件、错误 magic、未知版本和关键字段越界六类样本。只有系统能稳定区分这些情况,并且失败时不修改当前游戏状态,存档损坏检测才算真正建立起来。

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

目录与阅读设置

阅读设置

17

记录一个想法

如何判断存档文件已经损坏

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

登录哪都通