Azure Pipeline中.NET SDK版本适配问题求助：SonarQube扫描失败

问题根源 #

第一个错误是因为项目目标框架为.NET 8.0，但Azure Agent上仅安装了不支持.NET 8的.NET 5 SDK；删除.NET 5 SDK后，Agent上无可用的.NET SDK，触发了第二个“无法定位SDK”的错误。

修复步骤 #

• 安装匹配项目的.NET SDK
  项目目标是.NET 8.0，必须在Agent上安装.NET 8.x SDK：

  • 若使用微软托管Agent，在Pipeline的YAML中添加SDK安装任务：

    - task: UseDotNet@2
      inputs:
        packageType: 'sdk'
        version: '8.x'
    

  • 若为自托管Agent，直接下载.NET 8.x SDK安装包到Agent服务器完成安装。

• 确认SonarQube Scanner兼容性
  检查当前使用的SonarQube Scanner版本，确保它支持.NET 8.0。如果版本偏旧，升级到最新版的SonarQube Scanner for .NET，避免兼容问题。

• 校验global.json配置
  查看项目根目录是否存在global.json文件：

  • 若存在，确保文件中指定的SDK版本和已安装的.NET 8.x版本一致，示例：

    {
      "sdk": {
        "version": "8.0.100"
      }
    }
    

  • 若无需固定SDK版本，直接删除global.json，让系统自动使用已安装的最新SDK。

• 调整Pipeline的还原/构建命令
  对于.NET Core/.NET 5+项目，优先使用dotnet CLI命令替代旧的nuget命令，确保还原和构建步骤调用正确的SDK：

  dotnet restore
  dotnet build --no-restore
  

• 验证SonarQube集成流程
  确保Pipeline中SonarQube任务顺序正确：

  1. 先执行SonarQube初始化任务：

     - task: SonarQubePrepare@5
       inputs:
         SonarQube: '你的SonarQube服务连接名'
         scannerMode: 'MSBuild'
         projectKey: '项目唯一Key'
         projectName: '项目名称'
     

  2. 执行项目构建
  3. 最后执行SonarQube分析任务：

     - task: SonarQubeAnalyze@5
     

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