Azure Pipeline构建报错未找到Microsoft.NETCore.App 5.0.0如何解决

问题根因 #

主项目从 .NET 3.1 升级到 .NET 6 后构建提示缺失 Microsoft.NETCore.App 5.0.0 (x64) 框架，核心原因是构建链路中存在对 .NET 5 运行时的依赖，当前微软托管构建代理仅预装了 .NET 6.0.5 版本，无法直接满足运行要求，常见触发场景包括：

• 解决方案内存在未同步升级的子项目，TargetFramework 配置仍为 net5.0
• 引用的 NuGet 包基于 .NET 5 编译，且未配置运行时前滚策略
• 流水线使用的 .NET 相关构建任务版本过旧，任务本身依赖 .NET 5 运行时启动
• 项目根目录 global.json 强制锁定了 5.0 系列 .NET SDK 版本

修复方案 #

方案1：全链路清理 .NET 5 依赖（推荐） #

该方案无需额外安装旧版本运行时，是长期维护的最优解：

1. 全局扫描解决方案下所有 .csproj 文件，将所有项目的 <TargetFramework> 配置统一修改为 net6.0，排查是否有遗漏的测试项目、工具类项目残留旧版本框架配置
2. 检查解决方案根目录的 global.json 文件，调整 SDK 版本配置匹配当前环境预装版本，同时开启版本前滚策略，参考配置：

{
  "sdk": {
    "version": "6.0.5",
    "rollForward": "latestMajor"
  }
}

3. 将流水线中所有 .NET 相关任务（还原、构建、测试、发布）升级到最新稳定版本，避免旧版任务自身携带旧运行时依赖
4. 本地执行完整 dotnet restore、dotnet build、dotnet publish 流程验证无报错后，提交代码重新触发流水线即可。

方案2：流水线显式安装 .NET 5 对应组件 #

如果短期内无法完全清理 .NET 5 依赖，可以直接在流水线构建步骤最前端增加 .NET 版本安装步骤，构建代理会自动完成环境配置，让后续步骤可以识别到 5.0 版本框架。
在 azure-pipelines.yml 中所有 .NET 相关操作步骤之前插入以下任务：

- task: UseDotNet@2
  displayName: 'Install .NET 5.0 SDK'
  inputs:
    packageType: 'sdk'
    version: '5.0.408' # 5.0系列最新补丁版本，向下兼容5.0.0运行时要求
    installationPath: $(Agent.ToolsDirectory)/dotnet

如果仅需要运行时不需要完整SDK，可将packageType参数值改为runtime，version参数填5.0.0即可。

方案3：配置运行时前滚策略（临时兜底） #

如果确认依赖 .NET 5 的组件可以在 .NET 6 运行时上兼容运行，可以通过配置环境变量允许运行时自动使用高版本兼容运行，无需额外安装旧版本：
在流水线变量配置中新增如下变量：

• 变量名：DOTNET_ROLL_FORWARD
• 变量值：Major
  配置后.NET程序在找不到指定版本运行时时，会自动选择已安装的更高主版本运行时启动，绕过版本检查报错。

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