如何实现GitHub合并develop到master时自动校验关联Jira任务状态以阻止未完成任务的合并？

这个场景太常见了——生怕不小心把带未完成业务任务的代码合并到master，直接触发生产部署踩坑。结合你用的GitHub和Jira，给你几个实用的解决方案，从简单易上手到定制化都有：

一、优先选：GitHub Actions + Jira REST API（低成本、易维护） #

这是最推荐的方案，不用额外开发复杂工具，靠GitHub自带的Actions就能搞定核心逻辑：

1. 先做前置准备

   • 规范团队的commit message格式，要求每个提交必须关联Jira任务号（比如PROJ-123: 完成用户中心页面开发），这样能准确提取需要校验的任务。
   • 在GitHub仓库的「Settings → Secrets and variables → Actions」里添加Jira的认证信息：JIRA_EMAIL（你的Jira账号邮箱）、JIRA_API_TOKEN（Jira生成的API令牌）、JIRA_BASE_URL（比如https://your-domain.atlassian.net），避免明文暴露敏感信息。

2. 编写GitHub Action工作流
   在仓库的.github/workflows目录下新建jira-task-validation.yml文件，逻辑是：当有人创建从develop到master的PR，或者PR更新时，自动触发校验：

   name: Jira Task Validation
   on:
     pull_request:
       branches: [master]
       types: [opened, synchronize, reopened]
   
   jobs:
     validate-jira-tasks:
       runs-on: ubuntu-latest
       steps:
         - name: Checkout code
           uses: actions/checkout@v4
           with:
             fetch-depth: 0 # 拉取所有提交历史，方便提取任务号
   
         - name: Extract Jira issue keys from commits
           id: extract-issues
           run: |
             # 提取所有commit里的Jira任务号（格式匹配PROJ-XXX）
             ISSUES=$(git log --grep="PROJ-[0-9]\+" --format="%s" | grep -o "PROJ-[0-9]\+" | sort | uniq)
             echo "issues=$ISSUES" >> $GITHUB_OUTPUT
   
         - name: Check Jira issue statuses
           env:
             JIRA_EMAIL: ${{ secrets.JIRA_EMAIL }}
             JIRA_API_TOKEN: ${{ secrets.JIRA_API_TOKEN }}
             JIRA_BASE_URL: ${{ secrets.JIRA_BASE_URL }}
           run: |
             # 遍历每个任务号，调用Jira API检查状态
             for ISSUE in ${{ steps.extract-issues.outputs.issues }}; do
               STATUS=$(curl -s -u "$JIRA_EMAIL:$JIRA_API_TOKEN" "$JIRA_BASE_URL/rest/api/3/issue/$ISSUE" | jq -r '.fields.status.name')
               # 这里把"Done"换成你们团队定义的业务认可的完成状态
               if [ "$STATUS" != "Done" ]; then
                 echo "Error: Jira任务 $ISSUE 状态为 $STATUS，未完成业务校验！"
                 exit 1
               fi
             done
   

3. 设置分支保护规则
   去GitHub仓库的「Settings → Branches → Branch protection rules」，找到master分支，开启「Require status checks to pass before merging」，把刚才创建的Jira Task Validation加入必填检查项。这样只要校验失败，PR就无法合并到master。

二、更省心：用现成的Jira-GitHub集成工具 #

如果不想自己写脚本，GitHub Marketplace里有官方的Jira集成工具，比如atlassian/gajira-cli，能大幅简化配置：

• 步骤和上面类似，先配置Jira认证信息到Secrets。
• 用gajira-login登录Jira，gajira-find-issues自动提取commit里的任务号，再用脚本检查状态。官方文档里有现成的示例，改改状态判断逻辑就能用。

三、定制化需求：开发GitHub App或Jira插件 #

如果团队有特殊的业务规则（比如不仅要检查状态，还要关联Sprint、校验审批记录等），可以考虑自己开发：

• GitHub App：监听PR创建/更新事件，调用Jira API做自定义校验，然后给PR设置「status check」状态（失败/成功），阻止不合规的合并。相比普通Bot，GitHub App权限更规范，也更容易管理。
• Jira插件：反向联动，当Jira任务未完成时，自动标记对应的GitHub PR为不可合并。不过这种方式需要在Jira端做开发，适配性不如GitHub端的解决方案灵活。

最后补充几个小建议 #

• 除了校验任务状态，还可以加个逻辑：检查develop分支里的所有提交是否都关联了Jira任务，避免无任务的“裸提交”混入。
• 可以在PR描述里自动插入关联的Jira任务链接，方便评审人快速查看任务状态。

备注：内容来源于stack exchange，提问作者Hassen Gaaya