Jenkins与Jira集成Pipeline最后阶段报错排查求助

问题详情 #

Pipeline代码片段 #

stage('Integration with Jira') {
    steps {
        jiraComment(issueKey: "P34AMA-204", body: "test")
    }
}

报错堆栈 #

java.lang.NullPointerException
    at hudson.plugins.jira.JiraSite.createSession(JiraSite.java:530)
    at hudson.plugins.jira.JiraSite.getSession(JiraSite.java:506)
    at hudson.plugins.jira.pipeline.CommentStep$CommentStepExecution.run(CommentStep.java:83)
    at hudson.plugins.jira.pipeline.CommentStep$CommentStepExecution.run(CommentStep.java:64)
    at org.jenkinsci.plugins.workflow.steps.AbstractSynchronousNonBlockingStepExecution$1$1.call(AbstractSynchronousNonBlockingStepExecution.java:47)
    at hudson.security.ACL.impersonate(ACL.java:367)
    at org.jenkinsci.plugins.workflow.steps.AbstractSynchronousNonBlockingStepExecution$1.run(AbstractSynchronousNonBlockingStepExecution.java:44)
    at java.base/java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:515)
    at java.base/java.util.concurrent.FutureTask.run(FutureTask.java:264)
    at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1128)
    at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628)
    at java.base/java.lang.Thread.run(Thread.java:834)
Finished: FAILURE

环境信息 #

• Jenkins版本：2.263.3
• Jira版本：8.20.7
• Jenkins Jira插件版本：3.0.15

核心原因分析 #

这个NullPointerException发生在JiraSite.createSession方法，说明Jenkins无法创建与Jira的会话连接，主要由以下两种情况导致：

• 全局Jira站点未配置：Jenkins管理员未在系统全局配置中添加Jira服务器信息及对应的认证凭据（API Key或用户名密码），jiraComment步骤依赖这些配置建立会话，缺失时会触发空指针异常。
• 凭据访问权限不足：即使管理员配置了Jira站点，执行Pipeline的用户可能没有权限访问关联的全局凭据，导致无法获取认证信息完成会话创建。

解决步骤 #

1. 联系Jenkins管理员配置全局Jira站点：
   • 管理员需进入「Jenkins系统管理 → 系统设置 → Jira」区域，添加Jira站点：
     • 填写Jira服务器完整URL（例如https://your-jira-instance.com）
     • 选择已配置的凭据：针对Jira 8.20.7，推荐使用Jira用户的个人API Token作为认证方式，也可使用用户名+密码组合
     • 点击「测试连接」确认配置有效
2. 验证Pipeline执行用户的凭据权限：
   • 管理员需检查当前执行Pipeline的用户是否拥有访问Jira站点关联凭据的权限，确保凭据的作用域允许该用户使用
3. 多站点场景下指定站点名称：
   如果Jenkins配置了多个Jira站点，可在jiraComment步骤中明确指定站点名称：

   jiraComment(issueKey: "P34AMA-204", body: "test", site: "Your-Jira-Site-Name")
   

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