直接写类、实现getSubscribedEvents()、无需手动打标签三步即可运行；自动配置默认开启，但返回空数组或null会导致订阅器被忽略——这是最常踩的坑。
直接写类、实现方法、打标签，三步就能跑起来；自动配置默认开启，但getSubscribedEvents()返回空数组或null会导致订阅器被跳过——这是最常踩的坑。
监听器类怎么命名和定义
类名不强制带Listener后缀，但必须实现Symfony\Contracts\EventDispatcher\EventSubscriberInterface接口。别用老版本的Symfony\Component\EventDispatcher\EventSubscriberInterface，它在 Symfony 7 中已废弃。
- 必须声明静态方法
getSubscribedEvents()，返回关联数组：键是事件类（如UserRegisteredEvent::class），值是处理方法名或[方法名, 优先级]数组 - 处理方法可以是任意名称（比如
notifyOnRegister），参数类型必须匹配事件对象（如UserRegisteredEvent $event） - 方法签名里不要加
void返回类型提示——Symfony 7.2+ 的 EventDispatcher 不要求，加了反而可能因 PHP 版本兼容问题报错
getSubscribedEvents() 返回值写法细节
这个数组决定哪些事件会被接住，写错就等于没注册。常见错误是返回[]或null，此时 Symfony 直接忽略该订阅器，debug:event-dispatcher也查不到。
- 单事件绑定：
UserRegisteredEvent::class => 'onUserRegistered' - 带优先级：
UserUpdatedEvent::class => ['onUserUpdated', 20]（数字越大越先执行） - 同一事件多个处理器：
UserRegisteredEvent::class => [['onEmail', 10], ['onLog', -5]] - 字符串事件名也支持：
'user.registered' => 'onUserRegistered'，但推荐用类常量避免拼写错误
要不要手动配服务标签
Symfony 7 默认启用自动发现，只要类在src/下、实现了EventSubscriberInterface、且getSubscribedEvents()返回非空数组，就自动注册——不需要在config/services.yaml里写tags。
- 只有两种情况需要手动配：
App\EventListener\*以外路径的类（比如放在lib/），或想显式控制priority且不想写进getSubscribedEvents() - 手动配法：
App\EventListener\UserNotificationSubscriber: tags: [{name: 'kernel.event_subscriber'}]（注意不是kernel.event_listener） - 如果同时用了自动发现又手动打了标签，Symfony 会去重，不会重复注册
调试时监听器“看不见”怎么办
php bin/console debug:event-dispatcher查不到你的订阅器？大概率是缓存或返回值问题。
- 先清缓存：
php bin/console cache:clear --env=dev - 加
--show-private参数：php bin/console debug:event-dispatcher --show-private，否则私有服务不显示 - 检查
getSubscribedEvents()是否真返回了数组——在方法开头加throw new \Exception('test');确认是否被调用 - 运行
php bin/console debug:event-dispatcher kernel.request -v看详细堆栈，能暴露被静默吞掉的异常
真正容易被忽略的是：订阅器里的方法被调用时，事件对象已经是不可变的（immutable），修改$event属性不会影响后续监听器；如果需要中断流程，得用$event->stopPropagation()，但仅对支持传播的事件有效（比如自定义事件需继承Event并手动调用）。
