使用@slack/bolt与ngrok时HTTP请求未处理问题求助

核心问题定位 #

切换到HTTP模式后，Slack的互动请求（按钮点击）无法被Bolt正确路由处理，本质是请求路径不匹配、签名验证失败或Bolt配置未切换到HTTP模式导致的。

分步排查与修复 #

1. 确认Bolt的HTTP模式配置

socket模式与HTTP模式是互斥的，切换时必须彻底关闭socket模式并配置HTTP所需参数：

const { App } = require('@slack/bolt');

// 正确的HTTP模式初始化（不要加socketMode和appToken）
const app = new App({
  token: process.env.SLACK_BOT_TOKEN,
  signingSecret: process.env.SLACK_SIGNING_SECRET, // HTTP模式必须配置，用于验证Slack请求签名
});

• 若保留socketMode: true，Bolt会忽略HTTP路由配置，导致请求无法被处理。

2. 精确匹配Slack互动URL

Slack「互动与快捷方式」板块的URL必须完全对应Bolt的默认互动路由：

• 正确格式：https://<你的ngrok域名>.ngrok.io/slack/actions
• 错误示例：仅填根域名https://xxx.ngrok.io，或自定义路径未同步Bolt配置

如果需要自定义路由，需手动挂载Bolt的接收器路由：

// 假设用Express作为HTTP服务器
const express = require('express');
const server = express();

// 将Bolt的互动请求路由挂载到自定义路径
server.use('/my-custom-slack-actions', app.receiver.router);

server.listen(3000, () => {
  console.log('Server running on port 3000');
});

此时Slack的互动URL需改为https://xxx.ngrok.io/my-custom-slack-actions。

3. 验证请求是否到达本地服务

通过ngrok的内置控制台（http://localhost:4040）查看请求记录：

• 若POST /slack/actions请求的状态码是404：说明Bolt未正确挂载该路由，检查初始化配置或端口是否匹配
• 若状态码是403：说明签名验证失败，检查signingSecret是否与Slack后台的「Signing Secret」完全一致
• 若无请求记录：说明ngrok转发端口与本地服务端口不匹配，重新启动ngrok时指定正确端口（如ngrok http 3000）

4. 确保Action Handler正确注册

必须为按钮的action_id注册对应的处理器，且第一时间调用ack()确认接收：

// 替换为你按钮的实际action_id
app.action('view_button_click', async ({ ack }) => {
  // 必须先调用ack()，否则Slack会重复发送请求并报错
  await ack();
  // 后续业务逻辑
  console.log('按钮被点击');
});

• 若未注册对应action_id的处理器，Bolt会返回「Unhandled HTTP request」错误。

5. 排查中间件干扰

• 不要手动添加body-parser中间件：Bolt的接收器已经内置了请求体解析逻辑，重复解析会导致签名验证失败
• 日志中间件需挂载到Bolt的接收器路由上，才能捕获互动请求：

  app.receiver.router.use((req, res, next) => {
    console.log(`${req.method} ${req.path}`);
    next();
  });
  

内容的提问来源于stack exchange，提问作者Élodie Petit