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

热更新数据和启动数据怎么分层

热更新数据和启动数据怎么分层

配置热更新的关键不是“哪些数据能放服务器”,而是明确哪些数据必须随包存在、哪些允许远端覆盖,以及哪些一旦进入会话就不能再变化。本课用一套三层模型把加载顺序、覆盖规则和会话稳定性一起固定下来,避免运行中出现同一份配置前后不一致。

学习目标

  • 区分内置配置、远端可覆盖配置和会话快照的职责
  • 设计可验证的加载与覆盖顺序
  • 避免热更新直接改写正在进行的战斗或关卡状态

先把配置分成三个稳定层级

最实用的划分不是按文件名,而是按“缺失时能否启动”和“运行中能否变化”来判断。

内置配置必须随客户端发布。它负责最低可运行集合,例如配置结构版本、默认数值、资源索引基础信息和远端配置服务地址。即使网络不可用,客户端也应该能依赖它完成启动。

远端覆盖配置用于频繁调节但不值得重新发包的数据,例如活动参数、数值平衡、商店价格和掉落概率。远端配置只能覆盖明确允许覆盖的字段,不能任意改变结构。

会话快照不是第三份永久配置,而是玩家进入一局游戏、一个副本或一次匹配时,从当前有效配置复制出的只读版本。会话期间继续下载到的新配置留给下一次会话使用。

启动配置、远端覆盖与会话快照的分层关系

用固定顺序生成有效配置

可以把加载规则写成“内置为基线,远端只做白名单覆盖”。下面的 TypeScript 示例演示最小实现:远端只能修改允许热更新的字段,结构字段保持内置值。

ts
type GameConfig = {
  schemaVersion: number;
  damage: number;
  cooldownMs: number;
  assetBundleVersion: string;
};

const builtIn: GameConfig = {
  schemaVersion: 3,
  damage: 100,
  cooldownMs: 800,
  assetBundleVersion: "2026.10.0"
};

const remote: Partial<GameConfig> = {
  damage: 115,
  cooldownMs: 750,
  assetBundleVersion: "2026.11.0"
};

const hotFields = new Set<keyof GameConfig>(["damage", "cooldownMs"]);

function mergeHotConfig(
  base: GameConfig,
  override: Partial<GameConfig>
): GameConfig {
  const result = { ...base };

  if (hotFields.has("damage") && override.damage !== undefined) {
    result.damage = override.damage;
  }
  if (hotFields.has("cooldownMs") && override.cooldownMs !== undefined) {
    result.cooldownMs = override.cooldownMs;
  }

  return result;
}

console.log(mergeHotConfig(builtIn, remote));

预期输出:

text
{
  schemaVersion: 3,
  damage: 115,
  cooldownMs: 750,
  assetBundleVersion: '2026.10.0'
}

这里最重要的不是 Set 本身,而是“允许覆盖字段”必须显式维护。像资源包版本、协议版本、字段结构这类会影响兼容性的内容,不应和普通数值一起热改。

会话开始后冻结一份快照

假设玩家进入战斗时有效伤害是 115。此时服务端又发布 120,如果战斗逻辑每次攻击都直接读取全局配置,前半局和后半局可能使用不同规则,回放、结算和问题复现都会变困难。

进入会话时应复制一份只读快照:

ts
const effectiveConfig = mergeHotConfig(builtIn, remote);
const battleConfig = Object.freeze({ ...effectiveConfig });

console.log(battleConfig.damage);

预期输出:

text
115

后续下载的新值可以更新“下一会话使用的有效配置”,但不要修改当前 battleConfig。真正需要运行中动态变化的内容,应被建模成独立的实时状态,而不是偷偷借热更新配置实现。

每次远端覆盖都先验证再生效

远端配置至少需要经过三类检查:版本是否兼容、字段类型是否正确、数值是否在业务允许范围内。例如冷却时间要求大于零,掉落概率必须在合法区间,未知字段默认拒绝而不是静默接收。

发布链路可以固定为“下载候选配置 → 校验 → 生成新有效配置 → 原子替换 → 新会话读取”。这样即使下载失败、校验失败或版本不兼容,当前玩家会话也不会被破坏。

哪些数据不应该热更新

只要修改会改变代码控制流程、资源兼容关系或网络协议,就不适合按普通配置远端覆盖。典型例子包括配置结构版本、协议字段、必须与客户端资源一一对应的资源 ID、脚本入口以及决定序列化格式的字段。

判断标准可以压缩成一句话:启动必须有的随包内置,运营常调且结构稳定的允许远端覆盖,一旦进入会话会影响公平性或可复现性的就冻结成快照。

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

目录与阅读设置

阅读设置

17

记录一个想法

热更新数据和启动数据怎么分层

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

登录哪都通