游戏引擎 / 系统课时
查出事件监听重复执行
查出事件监听重复执行
一次点击加了两次分,可能来自两个订阅,也可能来自两个组件或两次发布。只给回调加防抖会掩盖原因。本节用纯逻辑重现不同闭包造成的重复订阅,再以稳定身份和成对清理修复,最后给出 Cocos 节点监听的定位入口。
学习目标
- 区分发布次数、订阅次数和对象实例数。
- 用稳定回调身份与明确清理范围修复重复执行。
- 验证重复启用、停用和恢复后的事件次数。
先给重复现象确定归属
在发布位置记录动作次数,在绑定位置记录实例与启用次数,在回调位置记录响应次数。若一次发布引起两个实例各执行一次,应检查场景对象是否重复;若同一实例响应两次,应检查是否订阅了两个不同回调。不要只看最后分数跳变就判断原因。
即使两个箭头函数代码相同,它们仍是不同对象;每次 bind 也生成新函数。某些事件系统会合并完全相同的回调与 target,但新闭包仍可能形成不同订阅。因此“多次 on 必然重复”并不准确,要同时检查 API 的去重规则与回调身份。

用真实业务通知重现和修复
文件:main.ts,完整纯 TypeScript 程序。Signal 是独立通知器,用于观察订阅身份,不伪装成 Cocos Node 或引擎测试。
export {};
class Signal {
private handlers: Array<() => void> = [];
on(handler: () => void): () => void {
this.handlers.push(handler);
return () => { this.handlers = this.handlers.filter(h => h !== handler); };
}
emit(): void { for (const handler of [...this.handlers]) handler(); }
}
const signal = new Signal();
let brokenCount = 0;
// 两次创建不同闭包,确实形成两个订阅。
const oldStops = [signal.on(() => { brokenCount++; }), signal.on(() => { brokenCount++; })];
signal.emit();
console.log(`broken:${brokenCount}`);
for (const stop of oldStops) stop();
class Listener {
count = 0;
private stop: (() => void) | null = null;
private handle = (): void => { this.count++; };
constructor(private events: Signal) {}
enable(): void {
// 重复启用幂等,同一实例只拥有一份订阅。
if (!this.stop) this.stop = this.events.on(this.handle);
}
disable(): void { this.stop?.(); this.stop = null; }
}
const listener = new Listener(signal);
listener.enable(); listener.enable(); signal.emit();
console.log(`fixed:${listener.count}`);
listener.disable(); signal.emit();
console.log(`disabled:${listener.count}`);
listener.enable(); signal.emit();
console.log(`restored:${listener.count}`);预期输出:
broken:2
fixed:1
disabled:1
restored:2停用后 count 保持一,恢复后只增加一,分别证明清理与恢复。先把旧错误订阅解除,再验证修复,避免旧监听污染结果。这些输出验证业务通知器的真实行为,不代表引擎内部已经运行过。
在组件里保持成对身份
文件:TapOwner.ts,片段示例,依赖 Creator 3.8 与有 UITransform 的可点击 UI 节点。
import { _decorator, Component, Node } from 'cc';
const { ccclass } = _decorator;
@ccclass('TapOwner')
export class TapOwner extends Component {
private count = 0;
onEnable(): void {
console.log(`bind:${this.node.name}`);
this.node.on(Node.EventType.TOUCH_END, this.tap, this);
}
onDisable(): void {
// 解除本实例订阅,不移除其他组件拥有的监听。
this.node.off(Node.EventType.TOUCH_END, this.tap, this);
console.log(`unbind:${this.node.name}`);
}
private tap(): void { console.log(`tap:${this.node.name}:${++this.count}`); }
}预期结果:将组件挂到 Canvas 下名为 TapArea 的可见 UI 节点,保存并预览,一次点击只出现 tap:TapArea:1。对同一预览实例反复禁用再启用组件后,一次点击仍只增加一;停用时点击不增加。
排除实例与发布重复
节点名相同仍可能是两个对象,正式排查可加入节点 UUID 或其他实例标识。先核对场景和 Prefab 是否都挂了组件,再核对初始化是否创建了重复对象。若回调身份正常但发布日志有两次,则应追踪按钮事件配置与代码事件是否同时触发同一业务命令。
销毁与停用的清理范围也应一致。若只在 onDestroy 解绑,界面关闭后仍可能收到来自共享总线的消息;若 onEnable 注册,就优先在 onDisable 对应解除。对模块级总线更要避免旧场景对象残留。
UI 事件传播也可能让子节点和父节点各执行一次合法监听,此时应先确认两个监听位置是否都是设计需要。阻断传播会改变交互规则,不能替代解除多余订阅。先把单节点的注册次数检查正确,再分析父子节点之间的消息路径。解除时也要核对总线对象是否与注册时相同,避免在新对象上清理旧订阅。
用次数回归确认根因消失
验收至少覆盖初次启用、重复启用、停用、恢复和对象重新创建。每项记录发布次数与响应次数,不要只记录最终显示“看起来正常”。重新创建会得到新计数器,应检查新旧实例是否同时被调用,而不是把计数归零误认为旧监听已经解除。防抖适合业务限频,不能替代监听生命周期修复。引擎参数对应依据 Cocos 3.8 事件 API。