Jenkins声明式流水线中SonarQube Scanner运行失败求助

嘿，我来帮你搞定这个问题！结合你给出的报错堆栈、Jenkinsfile和环境信息，咱们一步步拆解问题根源并修复：

首先，修正官方文档的语法问题 #

你观察得非常准确，新版Jenkins声明式流水线有两个硬性规则，官方文档的示例可能没跟上更新：

• 所有stage代码块内部必须明确包含steps块（你的原Jenkinsfile最后还少了闭合的}，这个也要补上）
• def关键字只能在script块里使用，声明式流水线的environment段里不能直接用它定义变量，要用tool这种原生步骤来配置

然后解决空指针异常（NPE） #

从报错堆栈java.lang.NullPointerException at org.jenkinsci.plugins.workflow.steps.ToolStep$Execution.run来看，核心问题是Jenkins找不到你指定的SonarQube Scanner工具实例，大概率是名称不匹配导致的，咱们来逐一排查：

1. 检查全局工具配置的名称 #

你在Jenkins「全局工具配置」里设置的SonarQube Scanner名称，必须和tool 'xxx'里的字符串完全一致。比如你配置的工具名称是SonarQube Scanner（不带版本号），那原Jenkinsfile里写的tool 'SonarQube Scanner 3.2.0.1227'就会找不到工具，直接抛出NPE。

2. 区分withSonarQubeEnv的参数含义 #

withSonarQubeEnv('xxx')里的参数是你在Jenkins「系统管理」→「SonarQube servers」里配置的SonarQube服务器名称，不是扫描器工具的名称！别把这两个搞混了，否则也会导致流程异常。

修正后的完整Jenkinsfile #

这里给你一份可以直接用的修正版，我标注了关键注意点：

pipeline {
    agent { 
        node { label "master" } 
    }
    environment {
        // 注意：这里的名称要和全局工具配置里的SonarQube Scanner名称完全一致
        SCANNER_HOME = tool 'SonarQube Scanner'
    }
    options {
        buildDiscarder logRotator(daysToKeepStr: '7')
    }
    stages {
        stage("Sonarqube Analysis") {
            steps {
                // 注意：这里的参数是SonarQube服务器的配置名称，不是工具名
                withSonarQubeEnv('SonarQube Server') {
                    // Windows节点用bat，Linux节点换成sh
                    bat "${SCANNER_HOME}/bin/sonar-scanner"
                }
            }
        }
    }
    // 可选：如果需要等待质量门结果，可以添加这个post步骤
    post {
        always {
            // 如果你安装了Quality Gate插件，启用这行可以让流水线等待质量门结果
            // waitForQualityGate abortPipeline: true
        }
    }
}

额外的环境检查点 #

• 你的Jenkins版本v2.107.3和SonarQube Scanner插件v2.7.1是兼容的，没问题
• 确认全局工具配置里的SonarQube Scanner已经设置了自动安装，并且Jenkins已经成功下载了3.2.0.1227版本（可以去Jenkins的工具安装目录下检查是否存在对应的文件夹）

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