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

多版本客户端如何共存配置

多版本客户端如何共存配置

线上游戏经常同时存在多个客户端版本,而配置服务通常只维护最新内容。如果所有客户端都直接拉“最新配置”,旧版本一旦遇到新增结构、删除字段或语义变化就可能解析失败。本节给出一套可落地的版本选择、兼容约束与回退链路。

学习目标

  • 能区分客户端版本、配置内容版本和配置结构版本的职责。
  • 能设计“按能力选择兼容配置”的下发策略,而不是简单追最新。
  • 能在远端配置不兼容或损坏时回退到可运行版本。

先把三个版本号拆开

多版本兼容最容易出错的地方,是把所有“版本”混成一个数字。至少应区分三类:

  • 客户端构建版本:表示当前程序代码能力,例如 build 420。
  • Schema 版本:表示客户端能理解的数据结构,例如 schema 3。
  • 内容版本:表示同一结构下的具体数值快照,例如 2026-10-08 第 17 次发布。

客户端是否能使用某份配置,首先取决于结构是否兼容,其次才是内容新旧。内容版本更新不代表 Schema 一定变化,Schema 升级也不意味着旧客户端必须立刻失效。

客户端按构建版本和Schema能力选择兼容配置并执行回退

服务端按“能力”而不是按“最新”选配置

下面是一个可运行的 Python 示例。它模拟服务端根据客户端 build 和支持的 Schema 选择最高可用版本;这里的数字只是示例,真实项目应由发布系统生成和维护。

python
configs = [
    {"schema": 2, "revision": 8, "minBuild": 300, "maxBuild": 399, "name": "schema2-r8"},
    {"schema": 3, "revision": 12, "minBuild": 400, "maxBuild": 499, "name": "schema3-r12"},
    {"schema": 4, "revision": 3, "minBuild": 500, "maxBuild": 599, "name": "schema4-r3"},
]

def select_config(client_build: int, supported_schema: int):
    candidates = [
        item for item in configs
        if item["minBuild"] <= client_build <= item["maxBuild"]
        and item["schema"] <= supported_schema
    ]
    if not candidates:
        return None
    return max(candidates, key=lambda item: (item["schema"], item["revision"]))

for build, schema in [(320, 2), (450, 3), (520, 4)]:
    result = select_config(build, schema)
    print(build, "->", result["name"] if result else "NO_COMPATIBLE_CONFIG")

预期输出

text
320 -> schema2-r8
450 -> schema3-r12
520 -> schema4-r3

这个策略的关键是:旧客户端继续拿旧结构的新鲜快照,新客户端才拿新结构。不要让服务端只维护一个“latest.json”,再要求所有客户端自己猜是否兼容。

兼容规则要优先选择加法变更

要让多个版本长期共存,Schema 演进应尽量遵守“旧读者能忽略、新读者有默认”的原则。新增可选字段通常最安全;直接重命名、删除字段或改变字段语义风险最高。

例如把 damage 从整数改成对象 {base, scale},即使字段名没变,也属于破坏性变更,因为旧客户端仍会按数字读取。此时更稳妥的做法是新增 damageProfile,保留旧字段给旧 Schema,等旧客户端退出支持范围后再清理。

可以把兼容策略归纳为三条:新增字段要有默认行为;删除字段要经过废弃窗口;语义变化要通过新字段或新 Schema 表达,而不是“原地变义”。

客户端必须验证并保留回退链

即使服务端已经做版本路由,客户端仍应在应用配置前检查 Schema、完整性和必要字段。推荐的回退顺序是:兼容的远端配置、最近一次验证通过的本地缓存、随包配置。

远端配置下载成功但校验失败时,不要覆盖“最后已知可用”缓存;否则下一次启动会失去退路。只有配置完整解析并通过业务校验后,才能把它晋升为新的 Last Known Good。

发布时用版本矩阵做验收

上线前至少验证三个组合:旧客户端配旧 Schema、当前客户端配当前 Schema、新客户端配新 Schema。若支持灰度,还要加入“当前客户端拿上一版内容快照”的回退测试。

最重要的验收标准不是“最新客户端能加载最新配置”,而是“仍在支持窗口内的每个客户端,都能拿到它理解的配置;任何不兼容版本都能被明确拒绝或回退”。做到这一点,多版本共存才是受控的兼容策略,而不是依赖运气。

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

目录与阅读设置

阅读设置

17

记录一个想法

多版本客户端如何共存配置

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

登录哪都通