如何在JIRA接收并处理Bitbucket Webhook？含PR审核触发状态变更场景

嘿，我来帮你捋清楚这个需求的实现思路！其实核心是要搭一个中间处理层，把Bitbucket的Webhook和JIRA的API串起来——毕竟JIRA本身没法直接接收并处理Bitbucket的Webhook payload，自定义场景下自己搞会更灵活。下面是具体的步骤和细节：

你需要一个轻量的中间服务（用你熟悉的Python/Node.js/Java都可以），承担三个核心角色：

1. 接收Bitbucket触发的Webhook请求
2. 解析请求内容，提取关键信息并关联到对应的JIRA任务
3. 调用JIRA API完成任务状态的自动更新

先把Bitbucket这边的触发条件设置好：

• 打开目标仓库的「Settings」→「Webhooks」→「Create webhook」
• Payload URL填你中间服务的接口地址（比如http://your-server-ip:port/webhook/bitbucket-pr）
• Triggers选择「Pull Request」下的「Approved」事件（只监听审核通过的动作，减少无效请求）
• 记得设置Secret（随便填一个复杂字符串），用来后续验证请求的合法性，防止恶意调用

这部分是核心，分几个关键环节：

• 接收并验证请求：
  处理Bitbucket发送的POST请求，首先要做签名验证：用你设置的Secret对请求Payload做HMAC SHA256哈希，和请求头里的X-Hub-Signature-256值对比，确保请求来自Bitbucket，不是伪造的。
• 解析Payload提取关键信息：
  从Bitbucket返回的JSON payload里，你需要拿到两个核心数据：
  • 确认PR状态是「Approved」（payload里pullrequest.state字段会标记为APPROVED）
  • 提取源分支名称（路径是pullrequest.source.branch.name）
• 关联JIRA任务：
  这里必须依赖分支命名规范，比如约定分支名必须包含JIRA任务KEY（像PROJ-123-feature/add-login这种），用正则表达式（比如[A-Z]+-\d+）从分支名里提取出PROJ-123这类任务ID。

  小贴士：一定要和团队统一分支命名规则，不然没法自动关联到对应的JIRA任务哦！

这部分需要和JIRA的REST API交互：

• 获取API权限：
  在JIRA个人设置的「Security」里生成一个API Token，用你的JIRA邮箱+Token做基础认证（请求头里加Authorization: Basic base64(邮箱:Token)）。
• 查询任务并确认可过渡状态：
  先调用GET /rest/api/3/issue/{issueKey}接口，确认任务存在，同时调用GET /rest/api/3/issue/{issueKey}/transitions接口，拿到该任务当前可用的状态过渡ID（比如「审核通过」对应的过渡ID可能是10005，这个ID和你的JIRA工作流配置有关）。
• 发送状态更新请求：
  用POST请求调用/rest/api/3/issue/{issueKey}/transitions，请求体指定过渡ID即可：

  {
    "transition": {
      "id": "10005"
    }
  }
  

别忘做容错处理：

• 记录每一次Webhook请求的日志（包括请求内容、处理结果、错误信息），方便后续排查问题
• 针对异常场景返回对应HTTP状态码：比如200表示处理成功，400表示请求无效（比如分支名没JIRA KEY），500表示内部错误，Bitbucket会根据状态码决定是否重试

如果你不想自己写中间服务，也可以试试Bitbucket和JIRA的官方集成：在JIRA里关联Bitbucket仓库后，通过「自动化规则」设置「当PR被批准时自动过渡JIRA任务状态」，这种方式适合标准场景，但灵活性不如自定义服务。

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