连接 Slack: 分步指南
将运行摘要发布到频道, 并在 NEXUS_SLACK_NOTIFY=true 时, 为每个失败、不稳定、混沌或视觉回归测试分别发送一条消息. 如果失败的测试有对应的 Jira 工单, 消息中会包含工单链接. 本指南将带你从零开始完成连接并验证, 同时列出可能遇到的错误及其原因和解决方法.
最后更新:
请妥善保管您的凭据。切勿将令牌、密钥、密码或 Webhook URL 粘贴到聊天中。请仅在 Studio → 设置 → 集成中输入,凭据会保存到工作区的 .env 文件中,并以圆点显示。对 AI 助手也是如此: 它可以指导您完成本指南中的步骤,但绝不需要您的令牌。
所需准备
- 一个允许你添加应用的 Slack 工作区.
- 一个用于目标消息频道的传入 Webhook URL.
获取凭据
- 在 Slack 中创建一个带有传入 Webhook (https://api.slack.com/messaging/webhooks) 的应用,并选择频道。
- 复制 Webhook URL。它以 https://hooks.slack.com/services/ 开头。该 URL 本身就是密钥。
- 将其保留在剪贴板中。除 Studio (下一步) 外,请勿粘贴到任何其他位置。
在 Studio 中连接
- 在 Studio 中,打开设置 → 集成 → Slack。
- 粘贴 Webhook URL,然后点击保存 & 发送测试消息。测试消息将发送到该频道。
- 开启
SLACK_ENABLED。如需为每个失败的测试发送一条消息,还需开启NEXUS_SLACK_NOTIFY。
验证连接是否正常
- 点击发送测试消息后,系统会回复 "已发送。",消息会出现在频道中。
- 运行任意测试。运行摘要将发送到该频道。
常见错误
| 你看到的现象 | 原因 | 解决方法 |
|---|---|---|
| "未配置 Webhook" | SLACK_WEBHOOK_URL 为空。 | 在设置 → 集成中粘贴 Webhook URL 并保存。 |
"SLACK_WEBHOOK_URL 不是 Slack 传入 Webhook" | 该值不是以 https://hooks.slack.com/services/ 开头的。 | 从 Slack 应用的传入 Webhook 页面重新复制 Webhook URL。 |
| HTTP 404 "no_service" 或 HTTP 403 "invalid_token" | Webhook 已被撤销或删除,或应用已从工作区移除。 | 创建一个新的传入 Webhook,并保存新的 URL。 |
| HTTP 404 "channel_not_found" 或 HTTP 410 "channel_is_archived" | Webhook 发送消息的目标频道已被删除或归档。 | 为一个可用频道创建新的 Webhook。 |
| "无法连接到 Slack (ENOTFOUND)" 或 "未在 20 秒内响应" | 此电脑无法连接到 Slack:可能是 VPN 或代理导致的,也可能是没有网络连接。 | 在同一台电脑上检查网络,然后重试。 |
| 测试消息发送正常,但未发送失败通知 | SLACK_ENABLED 为 false,或仅开启了运行摘要:要为每个测试发送消息,需设置 NEXUS_SLACK_NOTIFY=true。 | 开启这两个开关。 |
设置键
| 键 | 功能 | 有效值 | 如何检查 |
|---|---|---|---|
SLACK_ENABLED | 向 Slack 发送警报 | true 或 false | 收到测试消息后再开启。 |
SLACK_WEBHOOK_URL | 用于接收警报的 Slack 频道(保密,仅保存在此电脑上) | https://hooks.slack.com/services/… (不接受其他格式) | 点击发送测试消息,即可向该频道发送消息。 |
NEXUS_SLACK_NOTIFY | 每次测试失败时发送 Slack 警报 | true 或 false | 每个失败的测试都会发送一条消息,而不只是发送运行摘要。 |
更多: 所有集成, 设置指南, 故障排查. 其他指南: Jira Cloud, Azure Boards, Microsoft Teams, Telegram, GitHub Issues.
仍然遇到问题?请发送邮件至 [email protected],附上 Studio 显示的完整错误行。请勿包含令牌。