You need to enable JavaScript to run this app. 如何解决Laravel 8应用内通知无法通过Pusher推送事件的问题
优惠活动
大模型
产品
解决方案
定价
更多

如何解决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默认通知事件的,同样因为通道错位收不到回调。
  • 代码存在隐性逻辑错误
    1. Chat组件的send()方法中,创建ChatMessage实例时引用的$user1->name未定义,正确应该是$this->user1->name,否则会触发PHP未定义变量错误。
    2. 队列任务调用通知时,第三个参数(发件人姓名)传的是收件人($this->user)的名字,实际应该传发件人姓名,sender逻辑颠倒。

分步修复方案

1. 统一全链路通道名

二选一即可,推荐和现有授权规则对齐,减少改动量:

  • 修改User模型的receivesBroadcastNotificationsOn()方法,返回值和前端订阅、授权规则保持一致:
    public function receivesBroadcastNotificationsOn()
    {
        return 'App.User.' . $this->id;
    }
    
  • 如果要保留原来的users.{id}通道命名,需要同步做两处修改:
    1. 在channels.php中新增对应通道的授权规则:
      Broadcast::channel('users.{id}', function ($user, $id) {
          return (int) $user->id === (int) $id;
      });
      
    2. 修改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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.22 19:36:05