Slack API接受斜杠命令但模态交互返回403错误

核心问题回顾 #

• 斜杠命令可正常接收并处理，能触发模态框展示
• 交互请求（模态框操作）返回403错误，且无服务端日志，说明请求未到达服务
• 斜杠命令与交互配置了相同Request URL，新增/interactions路径也无效

针对性排查步骤 #

1. 校验Slack请求签名逻辑兼容性 #

Slack对斜杠命令和交互请求的签名计算规则存在细微差异，需确认服务端校验逻辑覆盖两种场景：

• 斜杠命令的请求体为application/x-www-form-urlencoded格式，交互请求为application/json格式。若服务端仅按form-data解析请求体计算签名，会导致交互请求的签名校验失败，被提前拦截。
• 检查签名校验代码是否正确处理X-Slack-Request-Timestamp头部，确保服务器时间与Slack服务器时间差在5分钟以内（Slack默认的时间窗口），时间差过大直接触发签名验证失败。

2. 核查Slack应用交互权限配置 #

• 进入Slack应用的Interactivity & Shortcuts页面，确认已开启交互功能，且Request URL配置无误（注意不要包含多余的末尾斜杠或空格）。
• 检查应用的权限范围，确保包含interactivity相关的必要权限（如chat:write、users:read），同时确认Bot用户已成功安装到目标工作区，且权限未被管理员撤销。

3. 排查网络层拦截规则 #

• 检查服务端防火墙、WAF或反向代理的配置，确认未对application/json类型的POST请求做拦截。斜杠命令使用form-data格式可通过，但交互请求的json格式可能被规则拦截。
• 核对服务端路由配置，确认同URL路径下允许接收json格式请求，部分框架会对未配置的Content-Type请求直接返回403。

4. 利用Slack内置工具定位问题 #

• 在Slack应用的Interactivity & Shortcuts页面点击「Verify」按钮，发送测试交互请求，观察服务端是否生成日志。若测试请求也无法到达，说明问题出在Slack与服务的网络链路或全局配置；若测试请求能到达，需检查模态框的回调ID是否与服务端处理逻辑匹配。
• 查看Slack应用的Settings > Error Logs页面，这里会记录请求被拒绝的具体原因（如签名无效、权限不足），是定位问题的关键依据。

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