Zsens Admin 插件事件监听：闭包传参与依赖注入的内存泄漏陷阱

在 Zsens Admin 插件开发中，事件监听是解耦模块的常用手段。ThinkPHP 8 的事件系统支持闭包与类方法两种监听方式，但一个极易被忽视的细节——闭包中错误引用外部变量——会导致插件卸载后事件残留、内存持续增长，甚至引发同一事件被重复触发的诡异 Bug。本文通过一组真实案例，对比错误写法与正确实现。

场景还原：插件卸载后事件仍在执行

某开发者编写了一个「订单完成后发送站内信」的插件，在 Plugin.php 的 enable 方法中注册事件监听：

// ❌ 错误写法：闭包直接捕获外部对象
public function enable()
{
    $messageService = new \app\plugin\message\Service\MessageService();
    
    \think\Event::listen('OrderPaid', function ($order) use ($messageService) {
        // 闭包持有 $messageService 实例的强引用
        $messageService->sendToUser($order->user_id, '订单支付成功');
    });
}

表面正常，实则埋下三颗雷：

雷点一：插件卸载时事件无法清理。 Event::off() 需要传入与原监听器完全相同的闭包实例才能移除，而上述闭包在运行时动态生成，disable() 方法中根本无法拿到相同引用，导致 disable() 后事件仍在队列中，插件逻辑幽灵般继续执行。

雷点二：重复启用插件导致事件堆积。 每次点击「启用」都注册一个新闭包，OrderPaid 事件触发时，站内信被重复发送 N 次。

雷点三：内存中对象图膨胀。 闭包通过 use 捕获的 $messageService 及其依赖（Think ORM 连接、Think View 引擎实例）被事件系统长期持有，无法被 GC 回收。

正确写法：类方法监听 + 依赖注入容器

Zsens Admin 基于 ThinkPHP 8 的容器体系，推荐利用类方法解耦事件注册与业务逻辑：

// ✅ 正确写法：类方法监听，由容器管理生命周期
namespace app\plugin\message;

use think\Event;

class Plugin
{
    public function enable()
    {
        // 使用类字符串，TP8 自动从容器解析
        Event::listen('OrderPaid', [OrderPaidListener::class, 'handle']);
    }
    
    public function disable()
    {
        // 类字符串作为标识，可精准移除
        Event::off('OrderPaid', [OrderPaidListener::class, 'handle']);
    }
}

// 独立的监听器类，依赖通过构造函数注入
namespace app\plugin\message\listener;

use app\plugin\message\service\MessageService;
use think\Container;

class OrderPaidListener
{
    // 延迟解析：事件触发时才从容器获取实例
    public function handle($order)
    {
        // 每次触发重新解析，避免状态污染
        $messageService = Container::getInstance()->make(MessageService::class);
        $messageService->sendToUser($order->user_id, '订单支付成功');
    }
}

进阶对比：三种引用方式的 GC 行为差异

若业务场景确实需要闭包（如极简插件），可退而求其次使用单例容器延迟解析，但必须在类属性中保存闭包引用以便卸载：

// ⚠️ 折中方案：仅适用于极简场景
class Plugin
{
    private static $listener;
    
    public function enable()
    {
        self::$listener = function ($order) {
            // 闭包内不捕获外部对象，每次从容器获取
            Container::getInstance()->make(MessageService::class)
                ->sendToUser($order->user_id, '订单支付成功');
        };
        Event::listen('OrderPaid', self::$listener);
    }
    
    public function disable()
    {
        Event::off('OrderPaid', self::$listener);
        self::$listener = null;
    }
}

Zsens Admin 插件开发的额外注意点

1. 事件命名空间隔离。 建议插件事件名使用 plugin.{plugin_name}.{event} 格式，避免多插件事件名冲突。Zsens Admin 的插件管理器在加载时会自动校验命名空间前缀。

2. 监听器类的自动加载。 监听器类必须位于插件目录的 listener 子目录，且遵循 PSR-4 规范，否则 TP8 容器在 app()->make() 时抛出 ClassNotFoundException。

3. 数据库事务边界。 若事件监听涉及写操作，需明确事务归属。主流程的事务回滚不会自动传播到事件监听，除非使用 Event::trigger() 的返回值控制或显式开启嵌套事务。

4. PHP 8.2 的匿名类变化。 闭包中若使用匿名类（如 new class { ... }），PHP 8.2 对动态属性的弃用警告可能暴露隐藏的依赖问题，建议监听器始终使用具名类。