如何解决Laravel 8应用内通知无法通过Pusher推送事件的问题
Laravel 聊天应用应用内通知投递失败排查与修复
核心问题定位
当前故障的核心是广播通知的投递链路存在多处命名不匹配,邮件通知走独立SMTP通道不受影响,因此可以正常发送,但依赖Pusher的应用内通知因为通道、事件名对不上,导致消息发不到前端订阅的通道上。
具体不匹配的点
- 实际推送通道和前端订阅通道完全错位
Laravel 广播通知的投递目标通道,完全由User模型里receivesBroadcastNotificationsOn()方法的返回值决定。当前你在该方法里返回的是users.{用户id},也就是说当给id=2的用户发通知时,后端会把广播事件推到private-users.2通道;但你的前端ChatNotification组件订阅的是private-App.User.1通道,Pusher控制台里看到的订阅也是这个通道,二者完全不是同一个通道,自然收不到推送。 - 通道授权规则不匹配
你在channels.php里配置的私有通道授权规则是针对App.User.{id}通道的,而实际后端推送的users.{id}通道没有配置任何授权规则,哪怕通道名一致,也会在授权环节被拦截。 - 监听事件名和实际广播事件名不一致
你在ChatNotification组件里写的监听规则是echo-private:xxx,MessageReceived,但通知类MessageReceived并没有使用MessageReceived作为广播事件名:Laravel默认广播通知的事件名是Illuminate\Notifications\Events\BroadcastNotificationCreated,你又在通知类里自定义了broadcastType()返回broadcast.message,和监听的事件名完全不匹配;你用JS调用的Echo.private(...).notification()方法是专门匹配Laravel默认通知事件的,同样因为通道错位收不到回调。 - 代码存在隐性逻辑错误
- Chat组件的
send()方法中,创建ChatMessage实例时引用的$user1->name未定义,正确应该是$this->user1->name,否则会触发PHP未定义变量错误。 - 队列任务调用通知时,第三个参数(发件人姓名)传的是收件人(
$this->user)的名字,实际应该传发件人姓名,sender逻辑颠倒。
- Chat组件的
分步修复方案
1. 统一全链路通道名
二选一即可,推荐和现有授权规则对齐,减少改动量:
- 修改User模型的
receivesBroadcastNotificationsOn()方法,返回值和前端订阅、授权规则保持一致:public function receivesBroadcastNotificationsOn() { return 'App.User.' . $this->id; } - 如果要保留原来的
users.{id}通道命名,需要同步做两处修改:- 在
channels.php中新增对应通道的授权规则:Broadcast::channel('users.{id}', function ($user, $id) { return (int) $user->id === (int) $id; }); - 修改ChatNotification组件的监听通道名,从
App.User.改成users.
- 在
2. 统一事件监听规则
- 如果使用Echo自带的
.notification()方法监听通知,只要通道名正确即可自动匹配默认事件,不需要额外处理事件名。 - 如果在Livewire中用
echo-private规则监听,需要匹配通知实际的广播事件名:- 可以直接删除
MessageReceived通知类里自定义的broadcastType()方法,使用Laravel默认的通知事件名; - 或者修改ChatNotification组件的getListeners方法,把事件名改成自定义的
broadcast.message:public function getListeners() { $channel = 'App.User.' . Auth::user()->id; return [ "echo-private:{$channel},broadcast.message" => 'notifyNewMessage' ]; }
- 可以直接删除
3. 修正代码逻辑错误
- 修正Chat组件send方法里的变量引用,把
sender' => $user1->name改为sender' => $this->user1->name - 修改
ProcessMailMessage队列任务的构造函数,增加接收发件人参数,调用通知时正确传入发件人姓名,避免sender值颠倒
4. 确认队列运行状态
因为MessageReceived通知类实现了ShouldQueue接口,需要确认队列进程正常运行,没有因为任务消费失败导致通知没有实际推送到Pusher。
验证方式
修复完成后,可以先在Pusher控制台给前端订阅的通道手动发一条测试事件,确认前端能收到回调;再实际发送一条聊天消息,观察Pusher控制台的事件推送日志,确认事件是发送到了和前端订阅一致的通道上。
内容的提问来源于stack exchange,提问作者alexmro
相关产品推荐
相关产品推荐

