laravel 5.5+ 中，event() 用于同步触发事件，dispatch() 仅用于队列任务，不可触发事件；监听器注册仅支持 eventserviceprovider::$listen 数组，不支持官方注解；事件类与监听器路径需严格匹配命名空间及大小写。
事件触发用 event() 还是 dispatch()？
直接说结论：Laravel 5.5+ 中，event() 是同步触发事件的快捷函数，dispatch() 属于队列任务体系，**不能用来触发事件**。混淆这两者是新手最常踩的坑——比如写了 dispatch(new UserRegistered) 却发现监听器根本没执行，因为 UserRegistered 是个事件类，不是任务类。
正确做法是：
- 定义事件类（如
App\Events\UserRegistered）后，用event(new UserRegistered($user))同步触发 - 若要异步处理，得配合队列：事件类实现
ShouldQueue接口，且监听器也需实现该接口（仅事件实现不够） -
event()底层调用的是EventDispatcher，不经过队列系统；而dispatch()走的是QueueDispatcher，只认Jobs
监听器注册写在 EventServiceProvider 还是用注解？
Laravel 不支持「注解注册监听器」，所谓「@listen」或「@event」都是社区包（如 spatie/laravel-event-sourcing）的扩展能力，官方默认只认 EventServiceProvider::$listen 数组。
常见错误是把监听器路径写错，比如：
- 写成
App\Listeners\SendWelcomeEmail::class（正确） - 误写为
App\Listeners\SendWelcomeEmail（缺::class，运行时报Class name must be a valid object or a string） - 事件类名拼错，比如
UserRegisterd少了个e，触发时静默失败（无报错，监听器不执行）
开发期建议开启 APP_DEBUG=true 并检查日志：storage/logs/laravel.log 里搜 event，能快速定位未注册或加载失败的事件。
为什么监听器没执行？检查这三处
监听器「写完了却没反应」，90% 出现在以下三个环节：
-
事件没真正被触发：确认调用
event()的代码实际运行到了（加Log::info('firing')或断点），别卡在 if 分支外 -
监听器没绑定到事件：检查
EventServiceProvider::$listen数组中，事件类完整命名空间是否和new时一致（包括大小写） -
监听器构造函数依赖无法解析：比如监听器
__construct()里用了未绑定的接口（如SomeServiceContract），Laravel 会跳过该监听器且不报错——这是最隐蔽的问题，可在监听器方法开头加Log::debug('running')验证
想解耦，但事件里传太多数据反而更紧耦合？
事件解耦的核心不是「用不用事件」，而是「事件里该塞什么」。常见反模式是往事件里传 $user->load('posts.comments') 这种已预加载的 Eloquent 模型，导致监听器强依赖当前查询上下文，甚至引发 N+1 或内存溢出。
更稳妥的做法：
- 事件里只传必要标识符，比如
new UserRegistered($user->id) - 监听器内部按需重新查库：
User::with('profile')->find($this->userId) - 如果确实需要原始数据快照（如注册时的表单字段），显式提取为数组或 DTO 类，避免传整个模型实例
- 注意：Eloquent 模型序列化进队列时会带大量冗余属性，用
toArray()或only()控制载荷大小
事件机制本身不保证解耦，传什么、怎么查、谁负责重建上下文，这些决策才真正决定模块间粘性。
