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

发现循环依赖该从哪里拆

发现循环依赖该从哪里拆

当攻击组件查询生命值,而生命值组件又直接命令攻击组件停止动作时,两者便形成循环依赖:初始化顺序难控制,单元测试也难隔离。本节用“角色死亡取消蓄力攻击”的场景,判断应该拆掉哪条依赖,并验证拆分后的行为。

学习目标

  • 区分代码依赖形成的环与正常的双向业务交互。
  • 根据查询、通知和协调职责选择接口、事件或协调者。
  • 用可运行代码拆除反向调用,并检查订阅生命周期。

先确定循环来自哪条引用

设 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 管理生命值与死亡事件,不知道谁在监听。

js
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();

预期输出:

text
可准备: true
准备中的攻击已取消
可释放: false

伤害造成生命值首次归零时,死亡事件只触发一次;正在准备的攻击被取消,因此释放失败。这里用同步回调让示例易于验证;如果生产项目使用异步事件队列,还要处理事件延迟期间的状态有效性。

检查是否只是把环藏进了事件里

首先验证组件的依赖声明:HealthComponent 不应导入、查找或持有具体的 AttackComponent;事件订阅也不能在回调中无限触发同一状态变化。随后分别测试满血攻击、死亡中断、重复受伤,以及销毁后不再接收通知。

若一条死亡事件逐渐承担掉落、任务、音频和动画等多个系统的决策,事件载荷应只表达死亡事实,具体动作仍由各订阅者或协调系统负责。事件能消除反向代码依赖,但不能替代明确的状态所有权、异常处理和生命周期管理。

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

目录与阅读设置

阅读设置

17

记录一个想法

发现循环依赖该从哪里拆

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

登录哪都通