启用自动扩缩容后Laravel Reverb WebSocket无法正常工作

可能的原因及排查方案 #

1. 确保Redis频道配置完全一致 #

• 所有Reverb和应用实例必须使用相同的Redis前缀：检查config/database.php中Redis配置的options.prefix，以及config/reverb.php里的redis.prefix，避免因前缀不同导致消息频道不匹配。
• 广播事件的broadcastOn方法生成的频道名称必须全局一致，不要引入实例ID、本地环境变量等动态值，否则不同实例的频道会脱节。

2. 验证Redis Pub/Sub的连通性 #

• 手动测试Redis消息推送：在终端执行redis-cli，输入命令：

  PUBLISH laravel_database_reverb:default "test broadcast message"
  

  然后查看所有Reverb实例的日志，确认是否都能收到这条测试消息。如果某实例无响应，排查该实例的Redis连接配置（主机、端口、密码、数据库编号）是否与其他实例一致。
• 检查Reverb启动日志：确认启动时输出了类似Subscribed to Redis channel: laravel_database_reverb:default的内容，若缺失则说明config/reverb.php的redis.channels配置有误。

3. 排查负载均衡器的Websocket配置 #

• 负载均衡器必须支持ws/wss协议转发，确保Websocket握手请求（HTTP Upgrade）能正确路由到所有Reverb实例，不要仅转发到固定实例。
• 无需配置会话粘性（Sticky Session），Reverb依赖Redis共享状态，但要确保负载均衡器不会过早截断Websocket长连接，调整超时时间至合理范围（如300秒以上）。

4. 确认广播事件的触发与推送 #

• 通过Pulse监控广播事件：查看Pulse的广播统计面板，确认用户发送消息时事件确实被触发并推送到Redis。
• 在广播事件的broadcastOn方法中添加日志，验证事件是否在应用实例中正常执行：

  public function broadcastOn()
  {
      Log::info('Broadcasting event to channel: '.json_encode($this->channel));
      return new Channel($this->channel);
  }
  

  若应用实例和Reverb实例分离部署，必须保证两者的Redis配置完全一致。

5. 解决Redis Pub/Sub的不稳定问题 #

• 检查Redis连接重连机制：Reverb实例断开Redis连接后，需确保能自动重新订阅频道，避免错过消息。
• 调整Redis客户端超时设置：在config/database.php的Redis配置中，增加超时时间：

  'options' => [
      'timeout' => 60,
      'read_timeout' => 60,
  ],
  

  防止Redis主动断开长连接导致订阅失效。

6. 启用详细调试日志定位问题 #

• 修改.env开启调试日志：

  LOG_LEVEL=debug
  REVERB_DEBUG=true
  

  重启Reverb实例后，再次触发消息，查看日志中的Redis交互、Websocket连接细节，定位是否存在连接超时、订阅失败等隐性错误。

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