Gitlab-Jira集成异常：合并MR后Jira工单无法自动转为Done状态

可能的原因及解决方法 #

1. 集成账号权限不足 #

检查Gitlab用于连接Jira的服务账号是否具备以下权限：

• 对目标工单的编辑权限
• 执行「Resolve」（ID:141）转态的权限
  若权限缺失，给该账号添加对应权限后重新测试。

2. Jira工作流转态存在隐藏条件 #

Jira的「Resolve」转态可能配置了必填字段校验、关联任务依赖或审批要求等条件。手动尝试对目标工单执行「Resolve」操作，若出现报错提示（如必填字段未填），则需要完善工单信息或调整工作流条件，确保自动转态能无阻碍执行。

3. Gitlab集成的状态映射不明确 #

由于Jira存在两个属于Done分类的状态（Done和Closed），Gitlab的自动匹配逻辑可能出现混淆：

• 进入Gitlab的Jira集成配置页面，找到「Transition Jira issues to their final state」选项，尝试手动指定转态ID为141（即「Resolve」转态），而非依赖自动匹配。

4. MR引用格式或合并方式问题 #

• 确认MR描述中的工单引用格式完全正确：Closes JIRA-TICKET-ID（注意工单ID大小写、拼写是否匹配）
• 检查MR是否通过直接合并完成，部分特殊合并方式（如squash merge）可能导致触发逻辑失效，可以尝试标准合并测试。

5. 集成同步日志排查 #

• 在Gitlab后台进入「Integrations -> Jira -> Logs」，查看合并MR时是否有发送转态请求，以及请求是否被Jira拒绝
• 在Jira的「Audit Log」中搜索目标工单，检查是否有来自Gitlab的转态操作记录，若有拒绝记录，根据提示调整配置。

6. Jira工作流的状态分类调整 #

若上述方案无效，可以考虑调整Jira工作流：将「Closed」状态的statusCategory改为其他分类（如「Closed」），避免与「Done」状态同属一个分类，消除Gitlab自动匹配的歧义。

内容的提问来源于stack exchange，提问作者Tomáš Tunys