怎么在 Jenkins 流水线中集成企业微信机器人通知插件

在 Jenkins 流水线中集成企业微信机器人通知，最推荐的方式是通过企业微信群机器人 Webhook 地址配合 Jenkins 的 HTTP 请求插件或专用通知插件实现。适用场景为构建状态同步、报警通知，风险边界在于 Jenkins 服务器需能访问企业微信 API 域名且 Webhook 地址不可泄露。

先说结论：集成核心在于获取正确的 Webhook 地址并在 Jenkins 中配置 HTTP POST 请求，专用插件可降低配置复杂度但通用 HTTP 插件更稳定。

适合：需要实时接收构建成功、失败或特定阶段状态的团队。
先准备：在企业微信管理后台创建群机器人并获取 Webhook 地址，确认 Jenkins 网络可达性。
验收：触发流水线后检查企业微信群聊是否收到消息，查看 Jenkins 控制台是否有 HTTP 状态码 200 返回。

命令速用版

若使用 Jenkins Pipeline 脚本配合 httpRequest 插件，可参考以下核心代码片段实现通知发送。

pipeline {
    agent any
    stages {
        stage('Notify') {
            steps {
                script {
                    def webhookUrl = 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY'
                    def body = """{
                        \"msgtype\": \"text\",
                        \"text\": {
                            \"content\": \"构建任务 ${env.JOB_NAME} 状态：${env.BUILD_RESULT}\"
                        }
                    }"""
                    httpRequest url: webhookUrl, 
                              httpMode: 'POST', 
                              contentType: 'APPLICATION_JSON', 
                              requestBody: body
                }
            }
        }
    }
}

为什么会这样

企业微信机器人通知本质是标准的 HTTP Webhook 回调机制。Jenkins 作为客户端向企业微信提供的特定 URL 发送 POST 请求， payload 符合企业微信定义的 JSON 格式即可触发消息推送，不依赖私有协议。

分步处理

第一步，在企业微信群聊中添加机器人，进入机器人设置页面复制 Webhook 地址，该地址包含关键密钥，需妥善保管。

第二步，在 Jenkins 系统管理中安装插件，推荐安装 Generic Webhook Trigger 或直接使用内置的 httpRequest 功能，若使用专用插件如 WeCom Notification 需在插件管理页搜索安装。

第三步，在 Jenkins 凭证管理中添加 Secret Text 类型凭证，将 Webhook 地址或 Key 存入凭证库，避免明文写在流水线脚本中。

第四步，编写 Pipeline 脚本，在 post 阶段或特定 stage 中调用 HTTP 请求，引用凭证中的地址，构造符合企业微信接口规范的 JSON 消息体。

怎么验证是否生效

触发一次 Jenkins 构建任务，观察企业微信目标群聊是否在构建结束后收到消息卡片或文本消息。登录 Jenkins 查看 Console Output，搜索 http 请求相关日志，确认返回状态码为 200 且无 SSL 握手错误。

常见坑

Jenkins 服务器所在网络若无法直接访问互联网，需配置 HTTP 代理才能连接企业微信 API 域名，否则会出现连接超时。Webhook 地址泄露会导致他人恶意调用发送垃圾消息，建议定期重置密钥。企业微信对机器人发送频率有限制，高频构建场景需做消息聚合，避免触发接口限流。

常见问题

专用插件和 HTTP 请求有什么区别

专用插件配置项更图形化，适合不熟悉脚本的用户；HTTP 请求方式更灵活，不依赖特定插件维护状态，长期稳定性更好。

为什么收到消息但显示发送失败

检查 Jenkins 控制台日志中的 HTTP 响应内容，企业微信接口会返回 errcode 和 errmsg，非 0 值表示发送失败，常见原因是消息内容包含敏感词或格式错误。

支持发送 Markdown 或卡片消息吗

支持，只需在 HTTP 请求体中将 msgtype 字段改为 markdown 或 template_card，并按照企业微信官方文档调整 content 结构。

参考来源

企业微信官方文档 - 群机器人
Jenkins 插件官网 - 插件搜索与说明