Jenkins流水线运行.NET Core SonarQube扫描时报错求助

核心原因 #

你在Jenkins流水线里执行dotnet sonarscanner报错，本质是Jenkins代理节点（不管是master还是slave）的.NET环境里没装dotnet-sonarscanner全局工具，或者工具所在路径没被加入系统PATH。本地能正常运行是因为你自己电脑上已经装了这个工具，但Jenkins的运行环境和本地是完全隔离的。

具体解决步骤 #

1. 在Jenkins代理节点上安装dotnet-sonarscanner全局工具 #

登录到Jenkins运行的代理机器（如果是本地Jenkins就是你的服务器），打开命令行执行以下命令：

dotnet tool install --global dotnet-sonarscanner

安装完成后，要确认工具所在目录在系统PATH里：

• Windows默认路径：C:\Users\<你的用户名>\.dotnet\tools
• Linux/macOS默认路径：~/.dotnet/tools

2. 验证工具是否能被Jenkins识别 #

可以在流水线的Sonar阶段先加一行验证命令，确认全局工具已安装：

stage('Begin Sonar') {
    tools {
        dotnetsdk 'dotnet-sdk-6.0'
    }
    steps {
        script {
            sh 'dotnet tool list --global' // 查看全局工具列表，确认sonarscanner在列
            withSonarQubeEnv('sonarqube-8.9.9') {
                sh 'dotnet sonarscanner begin /k:"ABPProjectDotnet" /d:sonar.host.url="http://auditor.pro-inspector.net:9000"  /d:sonar.login="*****"'
            }
        }
    }
}

3. 改用Jenkins全局配置的SonarQube Scanner工具 #

如果你已经在Jenkins全局工具里配置了SonarQube Scanner，也可以不用dotnet sonarscanner命令，直接用Jenkins提供的工具执行扫描，调整流水线如下：

pipeline {
    agent any
    tools {
        dotnetsdk 'dotnet-sdk-6.0'
        sonarQubeScanner 'sonarqube-8.9.9' // 引用全局配置的SonarQube Scanner
    }
    
    stages {
        stage('Checkout') {
            steps{
                checkout scm
            }
        }
        stage('Run Test') {
            steps {
                dir('TestProject') {
                    sh 'dotnet test'
                }
            }
        }
        stage('Sonar Scan') {
            steps {
                script {
                    withSonarQubeEnv('sonarqube-8.9.9') {
                        sh '''
                            sonar-scanner \
                                -Dsonar.projectKey=ABPProjectDotnet \
                                -Dsonar.host.url=http://auditor.pro-inspector.net:9000 \
                                -Dsonar.login=*****
                        '''
                    }
                }
            }
        } 
    }
}

注意：这种方式需要项目根目录有sonar-project.properties配置文件，或者在命令里补充源代码目录、测试报告路径等必要参数。

4. 检查Jenkins代理节点的PATH环境变量 #

如果已经装了工具但还是找不到，可能是Jenkins的PATH里没包含.dotnet/tools目录。可以在流水线里打印PATH确认：

sh 'echo $PATH' // Linux/macOS用这个，Windows换成bat 'echo %PATH%'

要是路径缺失，要么在Jenkins全局配置里添加环境变量，要么在流水线里临时补上：

sh 'export PATH="$PATH:~/.dotnet/tools"' // Linux/macOS
// Windows用：bat 'set PATH=%PATH%;C:\Users\<你的用户名>\.dotnet\tools'

额外注意事项 #

• 确保Jenkins代理节点的.NET SDK版本和本地一致（你用的是6.0，要确认代理节点已正确安装）。
• 如果用Docker作为Jenkins代理，得在Dockerfile里预先装好dotnet-sonarscanner，不然每次启动容器都会丢失这个工具。

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