Laravel-websockets事件无法广播求助（昨日正常今日重启后失效）

1. 确认WebSocket服务器状态与端口占用 #

• 重启电脑后，先重新启动WebSocket服务：执行php artisan websockets:serve，查看启动日志是否有端口占用、依赖缺失等报错。
• 检查默认端口（通常是6001）是否被其他进程占用：
  • Windows：netstat -ano | findstr :6001
  • Linux/Mac：lsof -i :6001
    若端口被占用，杀死对应进程或修改config/websockets.php中的端口配置。

2. 核对广播驱动配置一致性 #

• 检查.env中的核心配置，确保没有因重启导致的环境变量重置：

  BROADCAST_DRIVER=pusher
  PUSHER_APP_ID=你的应用ID
  PUSHER_APP_KEY=你的应用KEY
  PUSHER_APP_SECRET=你的应用SECRET
  PUSHER_HOST=127.0.0.1
  PUSHER_PORT=6001
  PUSHER_SCHEME=http
  PUSHER_APP_CLUSTER=mt1
  

• 确认config/broadcasting.php中的pusher配置未硬编码覆盖环境变量，保持与.env完全一致。

3. 验证事件类的广播规则 #

• 检查事件类的broadcastOn()方法，确保频道类型正确：
  • 公开频道：return new Channel('public-channel');
  • 私有频道：return new PrivateChannel('private-channel');
• 若设置了$broadcastAs属性，需保证前端监听的事件名称与该属性值一致；未设置则需监听事件类的完整命名空间（如App\Events\ChatMessageSent）。

4. 测试基础广播连通性 #

• 创建极简测试事件：

  <?php
  namespace App\Events;
  
  use Illuminate\Broadcasting\Channel;
  use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
  use Illuminate\Foundation\Events\Dispatchable;
  use Illuminate\InteractsWithSockets;
  use Illuminate\SerializesModels;
  
  class TestBroadcast implements ShouldBroadcastNow
  {
      use Dispatchable, InteractsWithSockets, SerializesModels;
  
      public $content;
  
      public function __construct()
      {
          $this->content = '测试广播内容';
      }
  
      public function broadcastOn()
      {
          return new Channel('test-channel');
      }
  }
  

• 添加测试路由：

  Route::get('/test-broadcast', function () {
      event(new \App\Events\TestBroadcast());
      return '广播已触发';
  });
  

• 访问路由后，查看WebSocket服务器日志，同时检查前端是否收到事件。若仍无日志，说明广播未成功发送至WebSocket服务。

5. 检查Redis队列状态（队列广播场景） #

• 执行redis-cli ping，确认Redis服务是否随系统重启自动启动，若未启动则手动启动Redis服务。
• 执行php artisan queue:work redis --verbose，查看队列任务的详细处理日志，确认是否有隐藏的执行报错。

6. 清除缓存与重启服务 #

• 执行以下命令清除所有缓存，避免旧配置残留：

  php artisan cache:clear
  php artisan config:clear
  php artisan route:clear
  

• 完全停止WebSocket服务和队列进程，再重新启动。

7. 核对前端监听配置 #

• 确保前端pusher-js配置与后端匹配：

  import Pusher from 'pusher-js';
  
  const pusher = new Pusher('你的应用KEY', {
      cluster: 'mt1',
      wsHost: '127.0.0.1',
      wsPort: 6001,
      forceTLS: false,
      encrypted: false,
      enabledTransports: ['ws', 'wss']
  });
  
  const channel = pusher.subscribe('test-channel');
  channel.bind('App\\Events\\TestBroadcast', function(data) {
      console.log('收到广播：', data);
  });
  

• 注意事件名称的转义，PHP命名空间中的反斜杠在JS中需写成双反斜杠。

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