Symfony自定义事件需遵循定义事件类、分发事件、注册监听器三步；推荐继承Event接口，事件在事务提交后触发，监听优先选用EventSubscriberInterface或__invoke方式，避免手动addListener。
Symfony自定义事件不是“注册个名字”就完事，关键在于结构清晰、触发可控、监听可配。核心三步：定义事件类、分发事件、注册监听器。下面直接说清楚怎么做、为什么这么设计、哪些细节容易踩坑。
定义一个干净的事件类
推荐继承 Symfony\Contracts\EventDispatcher\Event（非旧版 Event 类），不带任何逻辑，只封装数据。比如用户注册后需要通知多个模块：
- 创建
src/Event/UserRegisteredEvent.php - 构造函数接收业务对象（如
User $user），用public属性或 getter 暴露 - 可选定义常量
NAME = 'user.registered'，方便统一引用，避免字符串散落
不需要实现接口，也不用继承框架特定基类——只要是个普通 PHP 对象，就能被 dispatcher 正确分发。
在业务逻辑中准确触发事件
事件必须在“业务动作完成且状态稳定后”触发，不能在事务未提交前 dispatch，否则监听器可能读到脏数据。典型位置是服务方法末尾或控制器成功响应前：
- 注入
EventDispatcherInterface $dispatcher - 实例化事件对象：
$event = new UserRegisteredEvent($user); - 调用
$dispatcher->dispatch($event)（注意：新版 Symfony 不再传事件名字符串，对象自带类型信息）
不要在实体内部或仓储层 dispatch——那会破坏分层，让领域逻辑依赖基础设施。
监听方式选对才省心
两种主流注册方式，适用场景不同：
-
EventSubscriberInterface：适合一个类处理多个事件，或需依赖注入其他服务（如邮件服务、日志服务）。必须实现
getSubscribedEvents()，返回事件名与方法名的映射，支持优先级（如['onUserRegistered', 20]） -
__invoke 方法监听器：轻量级，类里只有一个
__invoke(Event $event)方法。Symfony 能自动发现并注册（需启用 autoconfigure），适合简单日志、指标打点等无状态操作
别手动在代码里用 addListener() ——那是测试或动态场景用的，正式项目靠配置驱动更可靠。
验证和调试小技巧
事件是否真被触发？监听器有没有执行？几个快速确认方式：
- 运行
php bin/console debug:event-dispatcher，查看user.registered是否在列表中，以及绑定的监听器路径 - 在监听器方法开头加
dd('fired');或写日志，观察请求/命令执行时是否输出 - 如果监听器没反应，先检查服务是否被正确加载（
debug:container | grep YourListener），再确认命名空间和文件路径是否符合自动发现规则（src/EventListener/或src/Event/）
不复杂但容易忽略。
