Jenkins集成Jira Cloud后jiraTransitionIssue报错及凭证异常求助

根据你描述的情况——已经完成Jira Cloud与Jenkins集成，jiraSendBuildInfo和jiraSendDeploymentInfo功能正常，但jiraTransitionIssue报错站点未配置，且添加Jira站点时无法选择已创建的Atlassian API Token凭证——我整理了几个针对性的排查和解决步骤：

1. 确认凭证类型与配置是否正确 #

由于Atlassian已废弃用户名密码认证，使用API Token时需要注意细节：

• 在Jenkins凭证管理中，优先选择 Atlassian API Token 类型创建凭证（如果你的插件版本支持该类型）；若没有此选项，选择 Username with password 类型，其中用户名填写你的Atlassian账号邮箱，密码填写生成的API Token。
• 确保凭证设置为全局可见，避免因项目权限限制导致在站点配置中无法被选中。

2. 检查Jira站点配置的名称匹配度 #

报错No JIRA site configured with <org>.atlassian.net name的核心原因是：你调用jiraTransitionIssue时指定的站点名称，和Jenkins全局配置里的Jira站点名称不匹配：

• 打开Jenkins全局配置（Manage Jenkins > Configure System），找到Jira Steps的站点配置区域。
• 确保添加的站点名称完全一致（包括域名前缀、大小写），比如调用时用site: '<org>.atlassian.net'，配置的站点名称就必须是<org>.atlassian.net，而非<orgname>.atlassian.net。
• 配置站点时，选中你之前创建的API Token凭证，保存后重新测试。

3. 升级Jira Steps插件到最新版本 #

你当前使用的1.6.0版本相对老旧，可能存在API Token识别和站点配置的兼容性问题：

• 进入Jenkins插件管理（Manage Jenkins > Plugins），搜索Jira Steps插件，检查是否有更新版本。
• 升级到最新稳定版本后，重新配置Jira站点和凭证，再测试jiraTransitionIssue功能。

4. 验证jiraTransitionIssue的参数配置 #

确保Pipeline脚本中jiraTransitionIssue的参数正确引用了配置的站点，示例如下：

jiraTransitionIssue(
    site: '<org>.atlassian.net', // 必须和全局配置的站点名称完全一致
    issueKey: 'PROJ-123',
    transition: 'In Progress'
)

按以上步骤排查后，应该能解决站点未配置和凭证不显示的问题。

内容的提问来源于stack exchange，提问作者Edcel Cabrera Vista