Laravel 8结合Pusher 5广播账号验证事件时出现array_merge错误
Laravel 8 集成 Pusher 5 实现账号验证事件广播报错排查
问题场景
基于Laravel 8框架、Pusher 5 SDK实现用户账号验证通过的事件广播逻辑,完成用户账号验证操作后触发Pusher端报错,报错截图可参考Pusher报错截图。
当前实现的Verified事件代码如下:
<?php namespace Illuminate\Auth\Events; use Illuminate\Queue\SerializesModels; use Illuminate\Contracts\Broadcasting\ShouldBroadcast; use Illuminate\Broadcasting\Channel; class Verified implements ShouldBroadcast { use SerializesModels; public $afterCommit = true; /** * 完成验证的用户实例 * * @var \Illuminate\Contracts\Auth\MustVerifyEmail */ public $user; /** * 创建新的事件实例 * * @param \Illuminate\Contracts\Auth\MustVerifyEmail $user * @return void */ public function __construct($user) { $this->user = $user; } public function broadcastOn() { return new Channel('users'); } public function broadcastAs() { return 'account-verified'; } public function broadcastWith() { return ['id' => 'heya']; } }
常见报错排查方向
- 最高发的命名空间配置错误
上述代码直接将自定义事件设置为Illuminate\Auth\Events命名空间,存在两个核心问题:- 按照Laravel默认的PSR-4自动加载规则,
Illuminate\开头的命名空间只会映射到vendor目录下的框架源码路径,写在app项目目录下的自定义类,会因为命名空间和文件路径不匹配根本无法被自动加载,框架依然会优先加载vendor目录下的原版Verified事件类(该类未实现ShouldBroadcast接口),完全不会执行自定义的广播逻辑; - 就算把文件硬放到vendor对应的路径下,后续执行composer更新时,手动修改的文件会被框架更新直接覆盖,存在极高的维护风险。
正确操作是把自定义Verified类移动到项目专属的app/Events目录下,对应命名空间修改为App\Events,确保可以被正常自动加载。
- 按照Laravel默认的PSR-4自动加载规则,
- Pusher基础参数配置校验
逐一核对项目配置:- 确认
.env文件中BROADCAST_CONNECTION值为pusher,没有错配为log、sync等其他驱动 - 核对Pusher应用的
PUSHER_APP_ID、PUSHER_APP_KEY、PUSHER_APP_SECRET、PUSHER_APP_CLUSTER参数和Pusher控制台获取的信息完全一致,没有错填 - 检查
config/broadcasting.php内的pusher配置项,Laravel 8配套使用的Pusher 5版本需要手动添加'useTLS' => true配置,否则非加密的请求会被Pusher服务端直接拦截
- 确认
- 队列运行状态校验
实现ShouldBroadcast接口的事件会默认推送到队列异步执行,如果没有配置正确的队列连接、也没有启动队列worker,广播请求根本不会被发送。临时测试阶段可以将事件实现的接口临时调整为ShouldBroadcastNow,绕过队列直接同步触发广播,即可定位是否为队列配置引发的问题。 afterCommit属性的适配检查
当前事件设置了public $afterCommit = true,代表事件需要等关联的数据库事务完全提交后才会触发。如果用户验证的流程中开启了数据库事务,需要确认事务最终成功提交,否则事件会被一直挂起,不会触发广播请求。- 事件加载逻辑的校验
Laravel自带的邮箱验证流程,完成验证操作时会自动触发框架核心命名空间下的Illuminate\Auth\Events\Verified事件。如果想自定义这个流程的广播逻辑,不要直接修改vendor目录下的框架源码,正确做法是在app/Providers/EventServiceProvider中注册对核心Verified事件的监听,在监听器内触发自定义的广播事件,避免后续版本升级出现兼容问题。 - 频道权限校验
当前使用的是公共广播频道users,不需要额外的鉴权逻辑;如果后续切换为私有频道,需要在routes/channels.php中配置对应频道的权限校验规则,否则会触发403鉴权报错。
内容的提问来源于stack exchange,提问作者George Bõtšihhin
相关产品推荐
相关产品推荐

