Laravel Websocket事件已订阅但消息无法触发，求排查解决

1. 检查事件类的广播配置 #

确保NewTrade事件类实现ShouldBroadcast接口，并正确定义广播频道：

namespace App\Events;

use Illuminate\Broadcasting\Channel;
use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
use Illuminate\Queue\SerializesModels;

class NewTrade implements ShouldBroadcast
{
    use SerializesModels;

    public $message;

    public function __construct($message)
    {
        $this->message = $message;
    }

    // 确认前端订阅的是该频道
    public function broadcastOn()
    {
        return new Channel('trade-channel');
    }
}

2. 验证广播驱动配置 #

检查.env文件的广播相关配置，确保指向本地websocket服务：

BROADCAST_DRIVER=pusher
PUSHER_APP_ID=你的应用ID
PUSHER_APP_KEY=你的应用密钥
PUSHER_APP_SECRET=你的应用密钥
PUSHER_HOST=127.0.0.1
PUSHER_PORT=6001
PUSHER_SCHEME=http
PUSHER_APP_CLUSTER=mt1
QUEUE_CONNECTION=sync

同步确认config/broadcasting.php中的pusher配置：

'pusher' => [
    'driver' => 'pusher',
    'key' => env('PUSHER_APP_KEY'),
    'secret' => env('PUSHER_APP_SECRET'),
    'app_id' => env('PUSHER_APP_ID'),
    'options' => [
        'cluster' => env('PUSHER_APP_CLUSTER'),
        'host' => env('PUSHER_HOST', '127.0.0.1'),
        'port' => env('PUSHER_PORT', 6001),
        'scheme' => env('PUSHER_SCHEME', 'http'),
        'encrypted' => false,
        'useTLS' => env('PUSHER_SCHEME') === 'https',
    ],
],

3. 确认队列服务状态 #

如果QUEUE_CONNECTION不是sync，必须启动队列worker：

php artisan queue:work

4. 查看服务日志定位错误 #

执行tinker触发事件后，查看Laravel日志排查异常：

tail -f storage/logs/laravel.log

5. 验证前端订阅逻辑 #

确保前端用Laravel Echo正确订阅对应频道和事件：

import Echo from 'laravel-echo';
import Pusher from 'pusher-js';

window.Pusher = Pusher;

window.Echo = new Echo({
    broadcaster: 'pusher',
    key: import.meta.env.VITE_PUSHER_APP_KEY,
    wsHost: import.meta.env.VITE_PUSHER_HOST,
    wsPort: import.meta.env.VITE_PUSHER_PORT,
    forceTLS: false,
    enabledTransports: ['ws', 'wss'],
});

// 监听事件并打印到控制台
window.Echo.channel('trade-channel')
    .listen('NewTrade', (e) => {
        console.log(e.message);
    });

6. 直接测试广播触发 #

在tinker中执行以下代码，验证广播是否正常触发：

broadcast(new \App\Events\NewTrade('Hi there'));

同时查看websocket仪表盘的连接数和事件统计，确认请求是否到达服务。

7. 检查事件类命名与拼写 #

确保tinker中执行的事件类命名空间正确，\App\Events\NewTrade类存在，构造函数参数匹配。

内容的提问来源于stack exchange，提问作者asimdev