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

重复订阅和取消订阅怎么处理

重复订阅和取消订阅怎么处理

游戏对象反复启用、禁用或销毁时,重复注册回调可能导致一次事件触发多次处理;忘记取消订阅则可能让事件总线持续持有失效对象。本篇通过明确的订阅契约和生命周期管理,让重复注册、注销和对象销毁后的行为都可预测、可验证。

学习目标

  • 定义重复订阅、空回调和重复注销的处理规则。
  • 将事件订阅与游戏对象的启用、禁用和销毁生命周期绑定。
  • 使用可运行的 C# 示例验证事件不会重复触发或形成悬挂订阅。

为订阅操作定义明确的契约

事件总线如果只维护一个回调列表,每次调用 Subscribe 都直接追加,就可能让同一个对象重复收到事件。例如生命值面板在每次打开时注册回调,却没有在关闭时清理,打开三次后,一次生命值变化就可能执行三次更新。

一种适合本地同步事件总线的约定是:相同委托只允许注册一次。使用 HashSet<Action<T>> 保存回调,可以利用委托相等性避免重复注册。

操作 约定行为 返回值或结果
首次订阅 保存回调 true
重复订阅 不增加注册数量 false
取消已有订阅 移除回调 true
重复取消订阅 保持未订阅状态 false
传入空回调 拒绝无效参数 ArgumentNullException
发布事件 调用当前订阅快照 每个已注册委托最多调用一次

这里的重复是指委托相等:相同目标对象上的相同实例方法通常可以判定为相等。两个不同的捕获闭包即使代码看起来相同,也不应假定是同一订阅。因此,建议把需要注销的回调保存为稳定的 Action<T> 字段,而不是在注册和注销时分别创建匿名函数。

把订阅与对象生命周期绑定

订阅关系本身也是需要管理的资源。对象停止接收事件时,应及时注销;对象永久销毁时,必须确保事件总线不再持有它的实例方法委托。

对于游戏中的界面面板,可以把订阅状态划分为三个阶段:

  • Disabled:对象存在,但没有事件订阅。
  • Enabled:对象已经订阅,可以接收事件。
  • Disposed:对象已释放,不允许重新订阅。

事件订阅从启用到销毁的生命周期状态图

在 Unity 中,常见做法是在 OnEnable 订阅、OnDisable 注销,并在 OnDestroy 确保完成最终清理。对于需要在禁用期间继续接收事件的持久服务,则应由其真实拥有者管理订阅,不应机械地套用界面对象的生命周期。

[!warning] 不要只在对象销毁时注销。如果面板只是隐藏而没有销毁,订阅仍然存在,隐藏期间也可能收到事件。另一方面,不要依赖垃圾回收自动解除订阅:事件总线持有的委托可能使对象持续存活。

实现可重复启用的订阅组件

下面使用 .NET 8 或更高版本的 C# 控制台项目模拟游戏中的生命值面板。将代码保存为 Program.cs,运行 dotnet run。示例不依赖 Unity,核心订阅行为可以迁移到游戏客户端。

csharp
using System;
using System.Collections.Generic;
using System.Linq;

var bus = new EventBus<int>();
using var panel = new HealthPanel(bus);

Console.WriteLine($"首次订阅: {panel.Enable()}");
Console.WriteLine($"重复订阅: {panel.Enable()}");
bus.Publish(80);

Console.WriteLine($"取消订阅: {panel.Disable()}");
bus.Publish(70);
Console.WriteLine($"重复注销: {panel.Disable()}");

panel.Enable();
panel.Dispose();
bus.Publish(60);

try
{
    panel.Enable();
}
catch (ObjectDisposedException)
{
    Console.WriteLine("已销毁: 禁止重新订阅");
}

try
{
    bus.Subscribe(null!);
}
catch (ArgumentNullException)
{
    Console.WriteLine("空回调: 已拒绝");
}

sealed class EventBus<T>
{
    private readonly HashSet<Action<T>> _handlers = new();

    public bool Subscribe(Action<T> handler)
    {
        ArgumentNullException.ThrowIfNull(handler);
        return _handlers.Add(handler);
    }

    public bool Unsubscribe(Action<T> handler)
    {
        ArgumentNullException.ThrowIfNull(handler);
        return _handlers.Remove(handler);
    }

    public void Publish(T payload)
    {
        // 使用快照,避免回调期间注销导致集合迭代失效。
        foreach (var handler in _handlers.ToArray())
            handler(payload);
    }
}

sealed class HealthPanel : IDisposable
{
    private readonly EventBus<int> _bus;
    private readonly Action<int> _callback;
    private bool _disposed;

    public HealthPanel(EventBus<int> bus)
    {
        _bus = bus;
        _callback = Show;
    }

    public bool Enable()
    {
        if (_disposed)
            throw new ObjectDisposedException(nameof(HealthPanel));

        return _bus.Subscribe(_callback);
    }

    public bool Disable() => _bus.Unsubscribe(_callback);

    private void Show(int hp)
    {
        Console.WriteLine($"面板 HP={hp}");
    }

    public void Dispose()
    {
        if (_disposed) return;

        // 释放对象之前解除事件总线对实例方法的引用。
        Disable();
        _disposed = true;
    }
}

预期输出:

text
首次订阅: True
重复订阅: False
面板 HP=80
取消订阅: True
重复注销: False
已销毁: 禁止重新订阅
空回调: 已拒绝

输出中的 True 和 False 是 C# 布尔值的默认文本表示。可以看到,发布 80 时面板只更新一次;注销后发布 70,以及销毁后发布 60,都没有触发面板回调。

注销期间的边界与验收

示例中的 Publish 先复制订阅集合,再逐个执行回调。这样允许某个订阅者在处理事件时调用 Unsubscribe,不会因直接修改正在遍历的集合而抛出集合修改异常。

但这种策略有一个重要边界:注销影响后续发布,不保证取消当前已经创建的分发快照中的调用。如果订阅者 A 在当前事件中移除订阅者 B,而 B 已存在于当前快照,B 仍可能收到这次事件。需要立即停止处理的对象,应在回调入口增加自身有效性检查。

还应确认以下约束:

  • Dispose 可以重复调用,不会重复清理或产生异常。
  • 已销毁对象不能通过 Enable 重新注册。
  • 不要依赖 HashSet 的遍历顺序实现业务先后关系。
  • 当前实现面向单线程同步分发;跨线程注册和发布需要额外同步措施。
  • 如果回调抛出异常,当前同步分发会中断,异常策略应由事件总线统一规定。

[!tip] 可以为调试构建记录当前订阅数量,并在场景退出后检查是否还有属于该场景的订阅者。若数量持续增长,优先排查未配对的订阅和注销、匿名闭包以及长期存在的静态事件总线。

建立稳定的委托身份、幂等的订阅操作和明确的对象释放入口,才能保证事件总线在界面反复开关、场景切换和对象销毁时保持可预测行为。

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

目录与阅读设置

阅读设置

17

记录一个想法

重复订阅和取消订阅怎么处理

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

登录哪都通