Git提交后钩子自动关闭JIRA工单遇请求错误求助

看起来你已经搞定了最麻烦的部分——从提交信息提取工单号、定位到JIRA工单，剩下的状态转换问题其实大多是权限、参数格式或转换ID不匹配的锅，我来给你一步步排查：

1. 先确认「正确的状态转换ID」 #

你用的31、5这些ID大概率不是你项目中「关闭工单」对应的正确转换ID，不同JIRA项目的转换ID是自定义的，不能瞎试。

用这段代码先打印出当前工单允许的所有状态转换，找到「关闭」对应的ID：

transitions = jira.transitions(issue)
for transition in transitions:
    print(f"转换ID: {transition['id']}, 转换名称: {transition['name']}")

运行后就能看到比如「关闭」对应的ID是21或者其他数值，用这个ID来调用接口，而不是随便填的数字。

2. 验证JIRA账号的权限 #

钩子使用的JIRA账号必须满足两个条件：

• 拥有关闭该工单的权限（比如项目的「开发者」或「管理员」权限）
• 当前工单的状态允许转换到「关闭」（比如不能从「已关闭」状态再关一次，或者有些项目要求必须先「解决」才能「关闭」）

最简单的验证方式：用这个账号手动登录JIRA，找到对应工单，尝试手动关闭它。如果手动都关不了，那脚本肯定也不行。

3. 补全「关闭工单的必填字段」 #

JIRA关闭工单时几乎都要求填写resolution（解决方式），有些项目还会有其他自定义必填字段，缺少这些会直接返回400错误。

你之前的代码里resolution={'id': '3...'}是不完整的，必须用完整的resolution ID。可以通过JIRA API GET /rest/api/2/resolution获取所有可用的解决方式ID，或者在JIRA界面的「解决方式」下拉框里右键检查元素找ID。

正确的调用示例应该是这样的：

jira.transition_issue(
    issue,
    transition='你找到的关闭ID',  # 比如'21'
    resolution={'id': '1'},  # 替换成你项目中「已完成」或对应解决方式的完整ID
    assignee={'name': 'pm_user'}  # 确保pm_user是JIRA系统内的用户名，不是显示名
)

4. 排查500内部错误 #

如果调用jira.transition(issue,'31')出现500，大概率是这个转换ID对应的操作在当前工单状态下不允许，或者该操作需要的必填字段没传，导致JIRA服务器内部处理出错。先通过步骤1确认该工单允许的转换，再用正确ID+必填字段调用。

5. 开启调试模式看具体错误 #

如果还是搞不定，开启JIRA Python库的调试日志，能看到完整的请求和响应内容，精准定位问题：

import logging
logging.basicConfig(level=logging.DEBUG)

运行后会打印出API请求的JSON数据、服务器返回的错误详情，比如「缺少必填字段：resolution」或者「无权限执行该转换」，直接就能知道哪里错了。

最后检查钩子运行环境 #

Git钩子的运行环境和你本地测试环境可能不一样：

• 确保钩子使用的Python环境安装了正确版本的jira库（用pip install jira更新到最新稳定版）
• 检查JIRA的URL、账号密码配置有没有拼写错误，比如URL末尾有没有带/，密码有没有特殊字符转义问题

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