游戏客户端架构 / 系统课时
热更新数据和启动数据怎么分层
热更新数据和启动数据怎么分层
配置热更新的关键不是“哪些数据能放服务器”,而是明确哪些数据必须随包存在、哪些允许远端覆盖,以及哪些一旦进入会话就不能再变化。本课用一套三层模型把加载顺序、覆盖规则和会话稳定性一起固定下来,避免运行中出现同一份配置前后不一致。
学习目标
- 区分内置配置、远端可覆盖配置和会话快照的职责
- 设计可验证的加载与覆盖顺序
- 避免热更新直接改写正在进行的战斗或关卡状态
先把配置分成三个稳定层级
最实用的划分不是按文件名,而是按“缺失时能否启动”和“运行中能否变化”来判断。
内置配置必须随客户端发布。它负责最低可运行集合,例如配置结构版本、默认数值、资源索引基础信息和远端配置服务地址。即使网络不可用,客户端也应该能依赖它完成启动。
远端覆盖配置用于频繁调节但不值得重新发包的数据,例如活动参数、数值平衡、商店价格和掉落概率。远端配置只能覆盖明确允许覆盖的字段,不能任意改变结构。
会话快照不是第三份永久配置,而是玩家进入一局游戏、一个副本或一次匹配时,从当前有效配置复制出的只读版本。会话期间继续下载到的新配置留给下一次会话使用。

用固定顺序生成有效配置
可以把加载规则写成“内置为基线,远端只做白名单覆盖”。下面的 TypeScript 示例演示最小实现:远端只能修改允许热更新的字段,结构字段保持内置值。
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));预期输出:
{
schemaVersion: 3,
damage: 115,
cooldownMs: 750,
assetBundleVersion: '2026.10.0'
}这里最重要的不是 Set 本身,而是“允许覆盖字段”必须显式维护。像资源包版本、协议版本、字段结构这类会影响兼容性的内容,不应和普通数值一起热改。
会话开始后冻结一份快照
假设玩家进入战斗时有效伤害是 115。此时服务端又发布 120,如果战斗逻辑每次攻击都直接读取全局配置,前半局和后半局可能使用不同规则,回放、结算和问题复现都会变困难。
进入会话时应复制一份只读快照:
const effectiveConfig = mergeHotConfig(builtIn, remote);
const battleConfig = Object.freeze({ ...effectiveConfig });
console.log(battleConfig.damage);预期输出:
115后续下载的新值可以更新“下一会话使用的有效配置”,但不要修改当前 battleConfig。真正需要运行中动态变化的内容,应被建模成独立的实时状态,而不是偷偷借热更新配置实现。
每次远端覆盖都先验证再生效
远端配置至少需要经过三类检查:版本是否兼容、字段类型是否正确、数值是否在业务允许范围内。例如冷却时间要求大于零,掉落概率必须在合法区间,未知字段默认拒绝而不是静默接收。
发布链路可以固定为“下载候选配置 → 校验 → 生成新有效配置 → 原子替换 → 新会话读取”。这样即使下载失败、校验失败或版本不兼容,当前玩家会话也不会被破坏。
哪些数据不应该热更新
只要修改会改变代码控制流程、资源兼容关系或网络协议,就不适合按普通配置远端覆盖。典型例子包括配置结构版本、协议字段、必须与客户端资源一一对应的资源 ID、脚本入口以及决定序列化格式的字段。
判断标准可以压缩成一句话:启动必须有的随包内置,运营常调且结构稳定的允许远端覆盖,一旦进入会话会影响公平性或可复现性的就冻结成快照。