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

场景切换后订阅为什么还在

场景切换后订阅为什么还在

切换游戏场景后,旧场景的 UI 和角色对象已经销毁,事件回调却可能继续执行,引起重复提示、异常或内存引用残留。本篇以 Unity 的静态事件发布者和场景组件为例,解释两种生命周期为何不一致,并通过订阅清理与场景切换测试解决这一问题。

学习目标

  • 理解持久事件发布者与场景对象生命周期不一致时的订阅残留原因。
  • 正确使用 Unity 的 OnEnable、OnDisable 管理事件注册和退订。
  • 通过两个场景验证旧订阅者已清理、新订阅者正常工作。

为什么场景对象消失后回调仍可能存在

假设游戏使用静态 DamageEvents 发布受伤消息。战斗 HUD 注册了一个事件处理方法,接收到伤害消息后刷新生命值显示。

玩家从 SceneA 切换到 SceneB 时,Unity 会卸载旧场景并销毁旧场景中的普通 GameObject,但静态事件字段通常不会因这次场景卸载而自动清空。

C# 事件内部通过委托保存订阅关系。对于实例方法订阅,委托会引用目标对象。如果事件发布者仍然存在,而旧订阅没有被移除,这条托管引用也可能继续存在。

由此产生两种典型故障:

  • 幽灵回调:旧场景组件的方法再次执行,访问已经失效的 Unity 对象时出现异常。
  • 重复响应:新场景又注册一个订阅者,事件发布时旧处理器和新处理器都可能被调用。

Unity 对象被销毁,不等于外部 C# 事件自动移除了指向其托管包装对象的委托。因此,不能把场景卸载当成静态事件订阅的自动清理机制。

将订阅与组件启停边界对齐

对普通场景组件而言,最直接的策略是在 OnEnable 注册事件,在 OnDisable 解除订阅。这样组件启用时接收消息,禁用、销毁或随场景卸载时停止接收消息。

场景切换时静态事件与场景订阅者的生命周期时序

这组生命周期回调具有明确的对应关系:

生命周期回调 事件处理职责
OnEnable 组件开始参与事件通信,注册处理方法
OnDisable 组件停止参与事件通信,解除处理方法
OnDestroy 执行对象销毁时额外需要的资源清理

OnDisable 不只在场景切换时触发,手动禁用组件或禁用 GameObject 时也会调用。再次启用时,OnEnable 会重新注册,因此这种模式适合只在组件活跃期间接收事件的 UI 和场景逻辑。

如果组件即使处于禁用状态也必须接收消息,则需要重新定义订阅的生命周期,例如在初始化阶段订阅,并在对象销毁阶段清理,而不是机械地使用 OnEnable 和 OnDisable。

在两个场景中复现订阅清理

下面建立一个可以直接在 Unity 中运行的最小测试。静态 DamageEvents 模拟跨场景存在的事件发布者,SceneDamageProbe 是随场景创建和销毁的订阅者。

代码使用 Unity 的 MonoBehaviour、SceneManager 和 GUILayout,不需要第三方插件。将以下完整代码保存为 SceneDamageProbe.cs,放入项目的 Assets/Scripts 目录。

csharp
using System;
using UnityEngine;
using UnityEngine.SceneManagement;

public static class DamageEvents
{
    public static event Action<int> DamageTaken;

    // 进入Play Mode时重置静态事件,兼容禁用域重载的编辑器配置。
    [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
    private static void ResetStatics()
    {
        DamageTaken = null;
    }

    public static void Publish(int amount)
    {
        DamageTaken?.Invoke(amount);
    }
}

public sealed class SceneDamageProbe : MonoBehaviour
{
    [SerializeField] private string nextSceneName = "SceneB";

    private void OnEnable()
    {
        // 组件启用时才开始接收伤害通知。
        DamageEvents.DamageTaken += OnDamageTaken;
        Debug.Log($"{gameObject.scene.name} subscribed");
    }

    private void OnDisable()
    {
        // 退订必须使用注册时的同一个方法引用。
        DamageEvents.DamageTaken -= OnDamageTaken;
        Debug.Log($"{gameObject.scene.name} unsubscribed");
    }

    private void OnDamageTaken(int amount)
    {
        Debug.Log($"{gameObject.scene.name} damage={amount}");
    }

    private void OnGUI()
    {
        if (GUILayout.Button("Publish Damage"))
            DamageEvents.Publish(10);

        if (GUILayout.Button("Switch Scene"))
            SceneManager.LoadScene(nextSceneName);
    }
}

为了让测试具有可重复性,在 Unity 编辑器中完成以下准备:

  1. 创建并保存两个场景,分别命名为 SceneA 和 SceneB。
  2. 将两个场景加入项目的构建场景列表,确保 SceneManager.LoadScene 能通过名称加载。
  3. 在 SceneA 中创建一个 GameObject,添加 SceneDamageProbe 组件,把 Next Scene Name 设置为 SceneB。
  4. 在 SceneB 中同样添加一个 SceneDamageProbe,把 Next Scene Name 设置为 SceneA。
  5. 保存场景,从 SceneA 进入 Play Mode。

运行时,Game 视图中会出现 Publish Damage 与 Switch Scene 两个简单测试按钮。先点击发布按钮,再点击场景切换按钮,进入新场景后再次发布伤害事件。

预期输出:Unity Console 中应依次出现包含以下内容的日志。

text
SceneA subscribed
SceneA damage=10
SceneA unsubscribed
SceneB subscribed
SceneB damage=10

重点不是日志格式,而是第二次发布事件时只有 SceneB damage=10,不会再次出现 SceneA damage=10。这说明旧场景订阅者已经退出事件列表,新场景订阅者仍然正常工作。

如果暂时注释 OnDisable 中的退订语句,再重复切换场景,可以对比观察残留订阅导致的异常或旧回调行为。由于旧 Unity 对象已被销毁,访问其属性时可能抛出 MissingReferenceException,而不是稳定输出旧场景日志。完成实验后应恢复退订代码。

处理重复注册与特殊生命周期

即使已经实现退订,真实项目仍可能因订阅位置不当出现重复响应。排查时应先确认一次消息究竟有多少合法订阅者,再判断是否存在同一对象重复注册。

如果同一个组件在 Awake 和 OnEnable 都注册了相同的方法,却只在 OnDisable 移除一次,就可能留下多余的委托条目。注册与退订应该采用统一策略,避免多个生命周期入口重复执行注册。

还要避免直接使用无法再次定位的匿名 Lambda 作为长期订阅处理器。例如在注册时临时创建的 Lambda,如果退订时重新写一个相同形式的 Lambda,通常是另一个委托实例,不能可靠地移除原先的订阅。需要 Lambda 时,应保存原委托实例以便退订。

对于跨场景常驻的音乐管理器、网络连接管理器等对象,不应因为普通场景卸载就清除其所有合法订阅。应由常驻对象自己的生命周期决定何时订阅和释放,或者将场景订阅与应用订阅分别放入不同事件域。

示例中的 ResetStatics 主要用于处理进入 Play Mode 时静态状态可能沿用的情况,尤其是 Unity 编辑器关闭 Domain Reload 时。它只在运行时初始化阶段清理旧静态事件状态,不会在每次普通场景切换时执行,因此不能替代场景组件的正常退订。

用事件日志验证生命周期边界

完成代码后,可以按照下面的顺序检查事件系统是否安全:

  1. 首次进入场景,确认每个预期订阅者只注册一次。
  2. 发布事件,确认有效订阅者各收到一次通知。
  3. 切换场景或禁用组件,确认对应的退订动作发生。
  4. 再次发布事件,确认旧订阅者不再被调用。
  5. 重复进入和退出同一场景,确认回调数量不会随切换次数增加。

若出现重复日志,优先检查是否存在多个场景组件实例或重复注册;若出现对象已销毁异常,优先检查静态事件引用、退订时机及匿名委托的使用方式。

场景切换后的订阅残留,本质上是事件发布者的寿命长于订阅者,却没有同步解除引用关系。让订阅与明确的生命周期边界对应,再通过重复切换场景验证回调数量,就能避免事件系统在长期运行中逐渐积累失效订阅。

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

目录与阅读设置

阅读设置

17

记录一个想法

场景切换后订阅为什么还在

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

登录哪都通