游戏客户端架构 / 系统课时
发现循环依赖该从哪里拆
发现循环依赖该从哪里拆
当攻击组件查询生命值,而生命值组件又直接命令攻击组件停止动作时,两者便形成循环依赖:初始化顺序难控制,单元测试也难隔离。本节用“角色死亡取消蓄力攻击”的场景,判断应该拆掉哪条依赖,并验证拆分后的行为。
学习目标
- 区分代码依赖形成的环与正常的双向业务交互。
- 根据查询、通知和协调职责选择接口、事件或协调者。
- 用可运行代码拆除反向调用,并检查订阅生命周期。
先确定循环来自哪条引用
设 AttackComponent 需要调用 HealthComponent.isAlive(),判断能否开始攻击;与此同时,HealthComponent 在生命值归零时直接调用 AttackComponent.cancel()。代码层面形成 Attack → Health → Attack:两端都必须认识对方的具体能力,构造时容易相互等待,替换组件也会牵动另一端。
排查时先记录每条边的发起方、被依赖方与用途。尤其要分清“读取状态”和“通知事实”:攻击能否释放属于攻击组件的决定,生命值组件只需对外说明“角色已死亡”,不该替攻击组件决定怎么取消动作。
循环依赖不等于两个组件之间存在双向数据流。重点看类、模块或构造器是否必须反向引用对方;消息从 A 流向 B,并不要求 A 在代码中知道 B 的类型。
依据交互语义选择切口
- 读取状态:调用方依赖只读能力,例如
isAlive();将能力约束为小接口,而不是暴露整个组件。 - 宣布变化:状态拥有者发布
onDeath事件,由使用者决定如何响应;这是本例应删除的Health → Attack直接调用。 - 协调两边:若必须依次修改多个组件并处理失败或返回结果,把流程交给角色宿主或独立协调系统,避免双方轮流命令对方。

图中的实线是代码层面的依赖,虚线是运行时事件通知。拆分后可能仍有回调引用,但 HealthComponent 不再导入或调用 AttackComponent 的具体 API;订阅者负责在自身销毁时解绑。
用死亡事件替代反向命令
下面是可直接在 Node.js 中运行的 JavaScript 示例。AttackComponent 只使用传入对象的 isAlive 和 onDeath 能力;HealthComponent 管理生命值与死亡事件,不知道谁在监听。
class HealthComponent {
constructor(hp) {
this.hp = hp;
this.listeners = new Set();
}
isAlive() {
return this.hp > 0;
}
onDeath(listener) {
this.listeners.add(listener);
// 由订阅者保存解绑函数,避免销毁后的残留回调
return () => this.listeners.delete(listener);
}
takeDamage(amount) {
if (!Number.isFinite(amount) || amount < 0) {
throw new Error("伤害值无效");
}
if (!this.isAlive()) return;
this.hp = Math.max(0, this.hp - amount);
// 生命值组件只公布状态变化,不直接访问攻击组件
if (!this.isAlive()) {
for (const listener of [...this.listeners]) listener();
}
}
}
class AttackComponent {
constructor(healthView) {
this.healthView = healthView;
this.preparing = false;
// 攻击组件自行决定收到死亡事件后的行为
this.unsubscribe = healthView.onDeath(() => {
this.preparing = false;
console.log("准备中的攻击已取消");
});
}
prepare() {
if (!this.healthView.isAlive()) return false;
this.preparing = true;
return true;
}
release() {
if (!this.preparing || !this.healthView.isAlive()) return false;
this.preparing = false;
return true;
}
dispose() {
this.unsubscribe();
}
}
const health = new HealthComponent(30);
const attack = new AttackComponent(health);
console.log("可准备:", attack.prepare());
health.takeDamage(30);
console.log("可释放:", attack.release());
attack.dispose();预期输出:
可准备: true
准备中的攻击已取消
可释放: false伤害造成生命值首次归零时,死亡事件只触发一次;正在准备的攻击被取消,因此释放失败。这里用同步回调让示例易于验证;如果生产项目使用异步事件队列,还要处理事件延迟期间的状态有效性。
检查是否只是把环藏进了事件里
首先验证组件的依赖声明:HealthComponent 不应导入、查找或持有具体的 AttackComponent;事件订阅也不能在回调中无限触发同一状态变化。随后分别测试满血攻击、死亡中断、重复受伤,以及销毁后不再接收通知。
若一条死亡事件逐渐承担掉落、任务、音频和动画等多个系统的决策,事件载荷应只表达死亡事实,具体动作仍由各订阅者或协调系统负责。事件能消除反向代码依赖,但不能替代明确的状态所有权、异常处理和生命周期管理。