游戏客户端架构 / 系统课时
控制事件生命周期
控制事件生命周期
事件系统真正难点不在于“能触发回调”,而在于监听器何时生效、何时失效,以及对象销毁后是否仍可能被调用。本课将实现一套可注销的监听机制,并用对象析构自动清理订阅,避免悬空引用、重复回调和资源泄漏。
学习目标
- 理解监听器注册、触发、注销与对象销毁之间的关系
- 使用订阅标识安全移除回调
- 验证对象销毁后事件系统不再访问该对象
生命周期中的风险
监听器通常由事件中心长期保存,而监听对象可能提前销毁。若回调捕获了对象指针,却没有在销毁前注销,事件中心下一次派发时就可能访问无效内存。
常见问题包括重复注册导致一次事件执行多次、注销时找不到原回调、遍历监听器时直接删除元素,以及对象已经销毁但回调仍保留在容器中。

用订阅标识管理监听器
下面的示例为每个监听器分配唯一标识。对象保存该标识,并在析构函数中主动注销。事件派发前先复制当前监听器列表,可避免回调执行期间修改原容器导致迭代器失效。
cpp
#include <cstddef>
#include <functional>
#include <iostream>
#include <unordered_map>
#include <utility>
#include <vector>
class EventBus {
public:
using ListenerId = std::size_t;
using Callback = std::function<void(int)>;
ListenerId subscribe(Callback callback) {
const ListenerId id = nextId_++;
listeners_.emplace(id, std::move(callback));
return id;
}
void unsubscribe(ListenerId id) {
listeners_.erase(id);
}
void emit(int value) {
// 使用快照,允许回调执行过程中安全注销监听器。
std::vector<Callback> snapshot;
snapshot.reserve(listeners_.size());
for (const auto& [id, callback] : listeners_) {
snapshot.push_back(callback);
}
for (const auto& callback : snapshot) {
callback(value);
}
}
private:
ListenerId nextId_ = 1;
std::unordered_map<ListenerId, Callback> listeners_;
};
class Player {
public:
explicit Player(EventBus& bus) : bus_(bus) {
listenerId_ = bus_.subscribe([this](int damage) {
health_ -= damage;
std::cout << "player health: " << health_ << '\n';
});
}
~Player() {
// 对象销毁前解除订阅,事件中心不再持有 this。
bus_.unsubscribe(listenerId_);
}
private:
EventBus& bus_;
EventBus::ListenerId listenerId_{};
int health_ = 100;
};
int main() {
EventBus bus;
{
Player player(bus);
bus.emit(30);
}
bus.emit(20);
std::cout << "emit after player destroyed" << '\n';
}预期输出
text
player health: 70
emit after player destroyed第二次派发没有输出玩家生命值,说明对象析构时已经移除监听器。若实际输出顺序不同,应检查容器类型或是否存在多个监听器;动态地址、线程编号等运行信息可能因环境而异。
注销与派发的边界
不要用“回调内容相同”来判断是否是同一个监听器,因为闭包对象通常无法可靠比较。使用整数标识或订阅句柄,才能精确注销指定回调。
多线程事件系统还需要为注册、注销和派发建立同步策略。简单做法是在访问容器时加锁,并在释放锁后调用快照中的回调,避免回调再次订阅时发生死锁。
Tips:对象拥有订阅句柄时,应让句柄的生命周期不长于对象。更完整的实现可把句柄封装成 RAII 对象,使其析构时自动注销。
验收检查
运行示例后,先确认对象存活期间事件可以正常触发,再确认对象离开作用域后不会继续收到事件。随后重复创建和销毁对象,检查是否出现重复回调、崩溃或监听器数量持续增长。
本课总结
- 事件中心通常比监听对象活得更久,因此必须明确注销时机
- 使用订阅标识或 RAII 句柄可以稳定管理监听器
- 派发时使用快照,可降低回调修改监听器集合带来的风险
下一课预告
下一课将进入对象与场景系统,从游戏对象的标识、状态和基础生命周期开始建立统一的数据模型。
按自己的节奏,确认真正理解。