使用PHP/Laravel通过WebSocket连接Slack API成功后无法接收事件

我使用PHP/Laravel、WebSocketClient与Guzzle开发Slack机器人，通过Guzzle完成认证获取WSS URL后，已成功建立连接，收到如下hello消息：

{#713
  +"type": "hello"
  +"num_connections": 1
  +"debug_info": {#716
    +"host": "applink-12"
    +"build_number": 42
    +"approximate_connection_time": 18060
  }
  +"connection_info": {#721
    +"app_id": "XXXXXXX"
  }
}  

其中app_id与预期一致，但这是我收到的唯一消息：

• 在Slack界面给机器人发送IM消息时无任何响应；
• 使用斜杠命令/options时立即报错：

/options failed with the error "dispatch_failed"

以下是控制台命令运行的消息处理循环代码：

$this->info("Listening to Slack Events");
$webClient = new WebSocketClient($this->wss."&debug_reconnects=true", ['persistent' => true, 'timeout' => 1800]);
// Listen to incoming slack messages
while (true) {
  try {
    $message = json_decode($webClient->receive());
    if ($message) {
         $messageType = $message->type;
         dump($message);  //Any event message from Slack should be dumped to the console
         dump($messageType);  

         switch($messageType){
           case 'hello':
               $webClient->setTimeout($message->debug_info->approximate_connection_time);
               $this->info("Approximate Timeout = ".$message->debug_info->approximate_connection_time /60 . " minutes");
           break;
           case 'disconnect':
                $this->info("Closing Connection");
                $webClient->close();
                $this->info("Closed Connection");
                exit();
           break;
           default:
                $this->error($messageType . " wasn't handled");
                $webClient->send('HTTP/1.1 200 OK');
      }
 }
} catch (\WebSocket\ConnectionException $e) {
 if ($e->getMessage() == 'Empty read; connection dead?')
 {
      $this->error("Timeout.. continuing");
 }
 else
 {
      $this->error("Failed:".$e->getMessage());
      return ['error' => $e->getMessage()];
 }

其他说明：

• 已在Slack API界面启用Socket Mode；
• 应用级和机器人级权限配置无误。

请问我哪里操作有误？该如何进一步调试？

问题分析与调试方案 #

1. 响应格式错误

Slack Socket Mode要求收到事件后，必须返回特定格式的JSON确认消息，而非你当前发送的HTTP/1.1 200 OK。对于带envelope_id的消息（如斜杠命令、事件回调），需返回：

{"envelope_id": "消息中的envelope_id值"}

错误的响应格式会被Slack判定为处理失败，直接触发dispatch_failed。

2. 未处理关键消息类型

Slack Socket Mode会发送多种消息类型（如event_callback、slash_command、interactivity），你的代码仅处理了hello和disconnect，其他类型直接抛错且响应无效，会导致Slack停止发送后续消息。

3. 具体调试与修复步骤

• 打印完整消息：确保dump($message)能输出所有内容，包括envelope_id和事件数据。若未收到消息，检查：
  • Slack API的Event Subscriptions中是否订阅了message.im、app_mention等所需事件；
  • 斜杠命令是否已启用（Socket Mode无需配置外部URL，但需确保命令本身处于激活状态）；
• 修正响应逻辑：针对带envelope_id的消息返回正确的确认：

  default:
       $this->error($messageType . " wasn't handled");
       // 检查并返回envelope_id确认
       if (property_exists($message, 'envelope_id')) {
           $webClient->send(json_encode(['envelope_id' => $message->envelope_id]));
       }
  

• 验证权限与安装：确认机器人权限包含chat:write、commands、im:history等必要权限，且已重新安装应用到目标工作区；
• 完善异常捕获：添加通用异常捕获，排查是否有其他错误中断消息处理；
• 检查JSON解析：添加解析错误检查，避免因消息格式问题导致后续逻辑中断：

  $message = json_decode($webClient->receive());
  if (json_last_error() !== JSON_ERROR_NONE) {
      $this->error('JSON解析失败: ' . json_last_error_msg());
      continue;
  }
  

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