游戏客户端架构 / 系统课时
场景切换后订阅为什么还在
场景切换后订阅为什么还在
切换游戏场景后,旧场景的 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 目录。
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 编辑器中完成以下准备:
- 创建并保存两个场景,分别命名为
SceneA和SceneB。 - 将两个场景加入项目的构建场景列表,确保
SceneManager.LoadScene能通过名称加载。 - 在
SceneA中创建一个 GameObject,添加SceneDamageProbe组件,把Next Scene Name设置为SceneB。 - 在
SceneB中同样添加一个SceneDamageProbe,把Next Scene Name设置为SceneA。 - 保存场景,从
SceneA进入 Play Mode。
运行时,Game 视图中会出现 Publish Damage 与 Switch Scene 两个简单测试按钮。先点击发布按钮,再点击场景切换按钮,进入新场景后再次发布伤害事件。
预期输出:Unity Console 中应依次出现包含以下内容的日志。
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 时。它只在运行时初始化阶段清理旧静态事件状态,不会在每次普通场景切换时执行,因此不能替代场景组件的正常退订。
用事件日志验证生命周期边界
完成代码后,可以按照下面的顺序检查事件系统是否安全:
- 首次进入场景,确认每个预期订阅者只注册一次。
- 发布事件,确认有效订阅者各收到一次通知。
- 切换场景或禁用组件,确认对应的退订动作发生。
- 再次发布事件,确认旧订阅者不再被调用。
- 重复进入和退出同一场景,确认回调数量不会随切换次数增加。
若出现重复日志,优先检查是否存在多个场景组件实例或重复注册;若出现对象已销毁异常,优先检查静态事件引用、退订时机及匿名委托的使用方式。
场景切换后的订阅残留,本质上是事件发布者的寿命长于订阅者,却没有同步解除引用关系。让订阅与明确的生命周期边界对应,再通过重复切换场景验证回调数量,就能避免事件系统在长期运行中逐渐积累失效订阅。