Jenkins使用Slack Notification Plugin出现部分频道连接失败问题咨询

基础信息确认 #

• 受影响版本范围：Jenkins 2.303.2，Slack Notification Plugin 2.28~2.40版本均可复现该问题
• 问题特征：仅随机部分私有/公开频道连接失败，其余频道可正常推送通知

根因定位方向 #

该问题基本和Jenkins、插件版本兼容性无关，核心出在Slack权限规则或频道配置匹配上：

• Slack应用权限不足
  Slack 2020年后调整了第三方应用权限规则，私有频道默认禁止未加入的应用推送消息，部分公开频道也可单独开启应用准入限制。如果你的Slack机器人未被邀请进入对应频道，就会出现推送失败的情况。
• 频道匹配规则异常
  Slack Notification Plugin 2.27版本之后，推送私有频道时优先识别频道ID而非频道名称，如果频道名称包含特殊字符、中文、空格，用名称匹配会偶发识别失败的问题。
• 配置优先级冲突
  如果Jenkins任务级单独配置了Slack推送参数，会覆盖全局配置的机器人Token、团队域名，错误的任务级权限配置也会导致部分绑定频道推送失败。

修复验证步骤 #

• 邀请机器人进入异常频道：在Slack对应频道输入命令 /invite @你的机器人名称，确认邀请成功
• 替换频道填写值：将Jenkins配置中异常频道的填写内容从「频道名称」替换为「频道ID」，频道ID可在Slack网页端打开对应频道后，从URL的/archives/路径后获取
• 连通性测试：在Jenkins全局Slack配置页点击Test Connection按钮，单独测试异常频道的推送是否正常
• 错误码排查：如果仍推送失败，开启Jenkins debug日志过滤slack关键词，查看具体报错信息：
  • 报错channel_not_found：确认频道ID正确性、机器人是否已加入频道
  • 报错invalid_auth：确认机器人Token是否有对应频道的消息推送权限
  • 报错is_archived：对应频道已归档，无法推送消息

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