Symfony 7.x中订阅器是监听器的一种实现方式，区别在于注册方式：EventListener通过函数式手动绑定事件，EventSubscriber通过实现getSubscribedEvents()静态方法约定式自动注册，二者均支持优先级控制，但注册需显式配置服务标签。
Symfony 7.x 的事件系统默认用的是 EventDispatcher，但“订阅器（Subscriber）”和“监听器（Listener）”不是平级概念——订阅器是监听器的一种实现方式，不是替代方案。别被名字带偏，关键在注册方式和接口契约。
为什么 EventListener 不需要实现接口，而 EventSubscriber 必须？
因为 EventListener 是纯函数式注册：你把一个可调用对象（比如闭包、静态方法、服务方法）直接绑定到某个事件名上，dispatcher 只关心“谁响应什么事件”，不检查类型。而 EventSubscriber 是约定式注册：它必须实现 getSubscribedEvents() 静态方法，告诉 dispatcher “我主动声明要监听哪些事件及优先级”，dispatcher 会自动解析并注册，省去手动绑定步骤。
常见错误现象：TypeError: EventSubscriberInterface::getSubscribedEvents() must be static —— 忘记加 static 关键字；或者返回数组格式错，比如写成 ['onUserCreated' => 'onUserCreated'] 而不是 ['user.created' => 'onUserCreated']（键是事件名，值是回调名或 [method, priority] 数组）。
-
EventListener更适合一次性、简单逻辑，比如日志记录、调试钩子 -
EventSubscriber更适合职责明确、多事件耦合的业务模块，比如用户注册后发邮件+初始化配置+触发分析埋点 - 优先级控制：两者都支持
priority参数，但EventSubscriber在getSubscribedEvents()中直接定义，EventListener在服务注册时通过tags设置
如何在 Symfony 7.1+ 中正确注册监听器（含优先级与参数传递）
Symfony 7.x 默认禁用自动事件发现（autoconfigure: false），所以必须显式声明服务标签。别指望只写个类就自动生效。
示例：注册一个监听 UserRegisteredEvent 的服务：
# config/services.yaml
App\EventListener\UserRegistrationListener:
tags:
- name: 'kernel.event_listener'
event: 'App\Event\UserRegisteredEvent'
method: 'onUserRegistered'
priority: 10
注意点：
-
event值必须是完整类名（FQCN），不能是短名或别名 -
method默认是__invoke，如果类有__invoke()方法，可省略method行 - 优先级数值越大越早执行；同优先级按服务定义顺序（非类名字母序）
- 若监听器依赖其他服务（如
MailerInterface），直接注入构造函数即可，无需额外配置
EventDispatcher 在测试中为何总报 “No listeners found”？
因为默认的 test 环境下，事件监听器不会自动加载——除非你在 config/packages/test/event_dispatcher.yaml 中显式启用，或在测试中手动添加监听器。
推荐做法：单元测试中绕过 dispatcher，直接调用监听器方法；集成测试中用 static::bootKernel() 后获取 EventDispatcherInterface 实例，并确认监听器已注册：
$dispatcher = static::getContainer()->get('event_dispatcher');
$listenerCount = \count($dispatcher->getListeners('App\Event\UserRegisteredEvent'));
self::assertSame(1, $listenerCount);
容易踩的坑：
- 忘记在
phpunit.xml中启用SYMFONY_DEPRECATIONS_HELPER=weak，导致某些弃用警告中断测试 - 使用
Mockery或Prophecy模拟 dispatcher 时，没 stubdispatch()方法的返回值，导致断言失败 - 测试中用了
setUpAfterClass()清理容器，但没重置 dispatcher 缓存，后续测试受影响
真正难的不是怎么写监听器，而是判断该不该用事件——跨域状态变更、强依赖解耦、异步化前置准备，这些才是事件系统的合理入口。别为了“看起来很架构”而在 User::save() 里 dispatch 一个 UserSavedEvent，然后又在同一个 bounded context 里监听它做同步操作。
