游戏客户端架构 / 系统课时
缺失配置时客户端怎么处理
缺失配置时客户端怎么处理
运行时读取配置时,真正危险的不是“没有值”,而是不同异常被当成同一种情况处理。合理的做法是先区分缺失键、非法值和空数据,再为每类情况定义可观察、可回退、可停止的策略,让错误停在局部而不是扩散成连锁崩溃。
学习目标
- 区分缺失键、非法值和空数据三类配置异常
- 为可降级与不可降级数据设计不同处理策略
- 用日志与默认值验证降级是否按预期发生
先把配置异常分成三类
“读不到配置”至少包含三种情况。缺失键表示目标 ID 根本不存在,例如角色引用了 skillId=2001,但技能表没有这一行;非法值表示记录存在,但字段不满足约束,例如冷却时间为负数;空数据则表示整张表或关键集合为空,常见于资源加载失败、版本不匹配或生成产物缺失。
这三类问题不能统一写成 return null。缺失单个非关键配置通常可以回退,非法值应优先拒绝进入运行时,整表为空则往往需要阻止系统继续启动。

把“查找”和“降级策略”放在同一层
如果每个业务模块都自己判断 null,策略很快会失控。更稳妥的方式是在配置仓库层集中处理:它负责校验、查找、默认值和错误记录,业务层只接收已经明确过语义的结果。
下面的 TypeScript 示例可以直接运行。speed 是可降级字段,缺失角色配置则视为关键错误;已存在但数值非法的配置在加载阶段直接拒绝。
type RoleConfig = {
id: number;
name: string;
speed?: number;
};
class ConfigRepository {
private readonly roles = new Map<number, RoleConfig>();
load(items: RoleConfig[]): void {
for (const item of items) {
if (item.speed !== undefined && item.speed <= 0) {
throw new Error(`invalid speed for role ${item.id}`);
}
this.roles.set(item.id, item);
}
}
getRole(id: number): Required<RoleConfig> {
const item = this.roles.get(id);
if (!item) {
throw new Error(`missing required role config: ${id}`);
}
// speed 属于可降级字段,缺失时使用明确的默认值。
return {
...item,
speed: item.speed ?? 3.5
};
}
}
const repo = new ConfigRepository();
repo.load([
{ id: 1001, name: "Knight" },
{ id: 1002, name: "Archer", speed: 4.2 }
]);
console.log(repo.getRole(1001));
console.log(repo.getRole(1002));
try {
console.log(repo.getRole(9999));
} catch (error) {
console.log((error as Error).message);
}预期输出:
{ id: 1001, name: 'Knight', speed: 3.5 }
{ id: 1002, name: 'Archer', speed: 4.2 }
missing required role config: 9999对象打印格式可能因运行环境略有差异,但关键结果应保持一致:1001 使用默认速度,1002 保留配置值,9999 被明确拒绝。
哪些情况可以降级
是否降级取决于“缺失后还能不能维持正确语义”。视觉文案、非关键音效、展示用标签等通常可以提供占位值;战斗数值主表、关卡入口、经济结算规则等一旦缺失,继续运行可能产生错误状态,应尽早失败。
即使允许降级,也应保留告警。至少记录配置类型、配置 ID、失败原因和当前版本,使问题能从线上日志追溯到具体生成产物。
避免把错误传播到更深层
常见反模式是先返回 null,再让角色系统、战斗系统、UI 层分别判断。这样同一个根因会在多个位置表现成“空对象”“数组越界”或“状态机不合法”,定位成本反而更高。
更稳妥的边界是:配置加载阶段负责结构与数值校验,仓库层负责缺失键策略,业务层只处理有效运行时对象。这样一旦配置有问题,错误会停在最接近数据源的位置。
验证降级策略是否真的有效
至少覆盖三条测试路径:正常配置能读取;可选字段缺失时得到预期默认值;关键记录缺失或字段非法时明确失败。发布前再用一份故意删掉字段或记录的测试配置运行客户端,确认日志、回退和阻断行为都与设计一致。
配置系统的目标不是“永不报错”,而是让错误以可预测的方式发生:能安全降级的就局部降级,不能保证正确性的就尽早终止,避免异常继续污染后续运行状态。