Laravel的观察者模式本质是模型事件的封装机制,Observer类通过反射将静态方法映射到对应生命周期钩子,依赖dispatchesEvents或自动注册机制触发,不监听任何东西。

直接说结论:Laravel 的「观察者模式」本质是模型事件(Model Events)的封装机制,Observer 类本身不监听任何东西,它只是把一堆 static 方法映射到对应模型生命周期钩子上——真正起作用的是 dispatchesEvents 或自动注册机制。
Observer 是怎么被 Laravel 自动调用的?
Laravel 不靠 PHP 的 SPL 观察者,而是靠模型事件分发 + 反射调用。当你执行 php artisan make:observer UserObserver --model=User,生成的类里每个方法名(如 created、updated)必须和模型支持的事件名完全一致,且首字母小写。
关键点在于注册方式:
- 手动注册:在
AppServiceProvider::boot()里调用User::observe(UserObserver::class) - 自动注册(Laravel 9+):只要在
boot()中调用Observes::register()并传入模型与观察者映射,或使用EventServiceProvider的$observe属性(推荐) - 注意:观察者方法接收的是模型实例,不是事件对象;没有
$event参数
哪些模型事件能被 Observer 捕获?
只有 Eloquent 定义的 10 个标准事件可用,比如 creating、created、updating、updated、saving、saved 等。自定义事件(如 user.login)不会触发 Observer 方法。
特别注意两个易错点:
-
creating和created区别:前者在写入数据库前(可修改属性、返回false中断保存),后者在插入成功后(已含id,但事务未提交) -
retrieved仅在首次从数据库取数据时触发,Eager loading关系数据不会触发它 -
deleting阶段还能访问模型关联数据;deleted阶段关联可能已释放(取决于是否用了withTrashed())
Observer 和 Model Events 直接监听的区别?
Observer 是语法糖,底层仍走 Event::dispatch()。但二者注册位置和优先级不同:
use Illuminate\Database\Eloquent\Model;
// 方式一:在模型内硬编码(不推荐)
protected $dispatchesEvents = [
'created' => UserCreated::class,
];
// 方式二:全局监听(更灵活,支持队列、中间件)
Event::listen(UserCreated::class, function (UserCreated $event) {
// ...
});
// 方式三:Observer(语义清晰,适合同域逻辑)
class UserObserver
{
public function created(User $user)
{
// 同步发邮件、记录日志等轻量操作
Mail::to($user)->send(new WelcomeMail());
}
}
性能提示:
- Observer 方法默认同步执行,若含 HTTP 请求、文件写入或耗时 DB 查询,应改用事件 + 队列
- 多个 Observer 注册同一模型时,按注册顺序执行,无内置优先级控制
- 如果在
saving中修改了模型字段,需手动调用$model->setDirty('field')才会真正更新到数据库
为什么 Observer 方法没执行?常见排查路径
不是代码写错了,大概率是注册漏了或时机不对:
- 检查是否在
AppServiceProvider::boot()中调用了Model::observe(Observer::class),且该调用不在if (app()->runningInConsole())分支里(否则 Web 请求不生效) - 确认模型没有设置
protected $dispatchesEvents = []清空了默认事件映射 - 运行
php artisan tinker,手动触发一次User::create([...]),看是否报错或静默失败 - 观察者方法名拼写错误(如写成
Created或onCreated)——Laravel 不会警告,直接跳过 - 使用了
DB::table('users')->insert(...):绕过了 Eloquent,Observer 完全不触发
最常被忽略的一点:Observer 只响应模型类自身的操作。如果你在 Repository 或 Service 里 new 了一个模型但没调用 save(),或者用了 updateOrCreate() 却忘了它内部仍走 Eloquent 生命周期——这些都得实测验证,不能只看代码有没有 save 字样。










