Slack API Bot无法识别reaction_added等事件求助排查

核心排查步骤 #

1. 补全Bot权限 #

reaction相关事件依赖reactions:read权限，即便已订阅事件，缺少该权限Slack也不会推送事件：

• 进入Slack API后台的「OAuth & Permissions」页面
• 在「Bot Token Scopes」中添加reactions:read权限
• 点击页面顶部的「Reinstall to Workspace」，重新授权Bot（必须执行此步骤才能让新权限生效）

2. 验证事件触发场景 #

Slack不会在所有场景下推送reaction事件，确认以下条件：

• Bot已加入发生reaction的频道（私有频道需手动邀请Bot进入）
• 测试时给其他用户的消息添加reaction（先排除Bot自身消息的特殊情况）
• 确保消息所在频道是Bot有权限读取的

3. 排查签名验证问题 #

若Slack的签名验证失败，会停止推送事件，可临时关闭验证做测试：
修改SlackEventAdapter初始化代码：

slack_event_adapter = SlackEventAdapter(os.environ['SIGNING_SECRET'], '/slack/events', app, verify=False)

关闭验证后若能收到事件，说明：

• .env文件里的SIGNING_SECRET与Slack API后台「Basic Information」中的不一致
• 环境变量未正确加载，可打印os.environ['SIGNING_SECRET']确认是否读取成功

4. 查看Slack事件日志 #

直接在Slack API后台定位问题：

• 进入「Event Subscriptions」页面
• 拉到最下方的「Recent Events」查看事件推送记录：
  • 若显示「Failed」，根据错误码排查：
    • 403：签名验证失败
    • 404：请求URL错误（比如ngrok重启后地址变更，需同步更新Slack的Request URL）
    • 500：服务内部报错，需排查代码逻辑

5. 检查ngrok请求记录 #

打开ngrok本地控制台（默认访问http://localhost:4040），查看「HTTP Requests」列表：

• 若无/slack/events的POST请求：说明Slack未推送事件，回到步骤1、2检查权限和触发场景
• 若有请求但响应异常：根据响应码排查服务端代码（比如添加错误日志）

代码调试建议 #

在代码中添加错误日志，便于定位异常：

@slack_event_adapter.on("error")
def error_handler(err):
    print(f"Event processing error: {err}")

另外，变量名payLoad可统一改为小写payload，符合Python命名规范（不影响功能，但提升代码可读性）。

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