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

事件监听怎样避免越绑越多

事件监听怎样避免越绑越多

复用对象最常见的隐蔽问题之一,是每次激活都重新订阅事件,却没有在回收时解除。对象看起来只生成了一次,但同一个回调可能被绑定两次、三次,最终表现为一次输入触发多次执行。本节用可运行示例复现累计注册,并给出稳定的对称管理方式。

学习目标

  • 识别重复激活导致的事件监听累计问题
  • 用 OnSpawn 与 OnDespawn 建立订阅和退订的对称边界
  • 通过监听次数和实际输出验证是否仍存在重复回调

累计注册为什么会发生

对象池不会销毁实例,只会让同一个实例反复经历“激活、回收、再激活”。如果订阅逻辑写在每次激活路径里,而退订只依赖对象真正销毁时执行,那么对象被复用多少次,就可能多出多少份监听。

典型链路是:第一次激活注册一次,回收时没有解除;第二次激活再次注册;此后一次事件就会依次调用两个相同委托。继续复用时,问题会按激活次数累积。

复用对象事件监听累计与对称解绑流程

用最小示例复现重复回调

下面模拟一个全局输入源和一个被对象池复用的按钮对象。错误版本每次激活都订阅,却从不退订;正确版本在回收时对称解除。

csharp
using System;

public sealed class InputBus
{
    public event Action? Confirm;

    public void RaiseConfirm() => Confirm?.Invoke();
}

public sealed class PooledButton
{
    private readonly InputBus _bus;
    private readonly bool _unsubscribeOnDespawn;
    private int _timesHandled;

    public PooledButton(InputBus bus, bool unsubscribeOnDespawn)
    {
        _bus = bus;
        _unsubscribeOnDespawn = unsubscribeOnDespawn;
    }

    public void OnSpawn()
    {
        _bus.Confirm += HandleConfirm;
    }

    public void OnDespawn()
    {
        if (_unsubscribeOnDespawn)
            _bus.Confirm -= HandleConfirm;
    }

    private void HandleConfirm()
    {
        _timesHandled++;
        Console.WriteLine($"handled={_timesHandled}");
    }
}

public static class Program
{
    public static void Main()
    {
        var bus = new InputBus();

        var broken = new PooledButton(bus, unsubscribeOnDespawn: false);
        broken.OnSpawn();
        broken.OnDespawn();
        broken.OnSpawn();
        bus.RaiseConfirm();

        Console.WriteLine("fixed");

        var fixedButton = new PooledButton(bus, unsubscribeOnDespawn: true);
        fixedButton.OnSpawn();
        fixedButton.OnDespawn();
        fixedButton.OnSpawn();
        bus.RaiseConfirm();
    }
}

预期输出:

text
handled=1
handled=2
fixed
handled=3
handled=4
handled=1

第一段只触发了一次事件,却连续输出两次,说明错误对象已经累计了两个监听。进入第二段时,错误对象仍留在总线上,所以它又输出两次;正确对象只输出一次。这也说明重复订阅不仅影响自身,还会污染后续测试和场景。

正确做法是让注册与解除成对出现

稳定规则很简单:只要订阅发生在 OnSpawn,解除就应该发生在 OnDespawn。不要把退订放到析构函数或“对象真正销毁”路径,因为池化对象可能在很长时间内都不会销毁。

如果同一个对象可能在尚未回收时重复执行 OnSpawn,还应额外保证幂等性。常见做法是维护一个布尔标记,只允许从“未订阅”切换为“已订阅”;或者在订阅前先执行一次安全的 -= ,再执行 +=。前者更能暴露生命周期调用错误,通常更适合作为工程约束。

哪些监听都要纳入回收检查

除了语言级事件,消息总线、输入系统、网络回调、定时器和观察者模式都存在同样风险。判断标准不是 API 名称,而是“这个对象是否把自己的回调注册到了另一个长生命周期对象上”。

回收前应确保两件事:所有外部订阅已经解除,所有由本次激活启动的延迟任务都不会在下次复用后继续回调旧逻辑。只要注册与解除严格围绕复用生命周期对称执行,事件监听就不会随着对象重复激活而悄悄增长。

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

目录与阅读设置

阅读设置

17

记录一个想法

事件监听怎样避免越绑越多

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

登录哪都通