Azure DevOps CI管道Agent任务无.Net构建选项触发MSB4019报错

MSB4019报错和.NET Core版本不匹配无关，核心原因是用了适配.NET Core/.NET 5+的工具链构建传统.NET Framework 4.7.2项目，两者构建体系完全不兼容。

报错里提到的Microsoft.WebApplication.targets是传统ASP.NET Web Application项目的专属构建目标文件，属于Visual Studio原生MSBuild组件的一部分，不会随.NET Core SDK分发。选择.NET Core类型的任务后，管道会默认调用dotnet build命令执行编译，它只会在.NET Core SDK的安装目录（也就是报错里的C:\Program Files\dotnet\sdk\5.0.408\路径）下查找构建目标文件，自然找不到对应文件，最终抛出错误。

首先确认基础前提：传统.NET Framework项目只能运行在Windows环境，必须选择Windows类型的Agent池，微软托管Agent优先选windows-latest即可，该镜像预装了Visual Studio、.NET Framework 4.7.2开发套件、对应版本的NuGet和MSBuild，不需要额外手动安装SDK。

按以下顺序配置管道任务即可：

• 第一步：NuGet依赖还原
  不要选择.NET Core CLI分类下的dotnet restore，在任务库搜索NuGet restore（归属于Package分类）添加，配置项如下：
  • 要还原的目标：选择仓库内的.sln解决方案文件
  • NuGet版本：选择4.0及以上版本即可，托管Agent自带的默认版本完全兼容.NET Framework 4.7.2项目
  • 如果有私有NuGet源，在Feeds配置项中添加对应源地址即可
• 第二步：项目编译构建
  不要选择.NET Core分类下的dotnet build，在任务库搜索Visual Studio Build（归属于Build分类）添加，配置项如下：
  • 要构建的目标：同样选择你的.sln解决方案文件
  • 构建参数：填写/p:Configuration=Release，如果需要构建时同步发布可以追加/p:DeployOnBuild=true /p:PublishProfile=你的本地发布配置文件名
  • 解决方案平台：和本地Visual Studio中配置的平台保持一致即可，一般选Any CPU
  • Visual Studio版本：选择Latest即可，Agent会自动调用已安装的最新版MSBuild适配目标框架版本
• 第三步（可选）：单元测试执行
  如果项目带单元测试，不要用dotnet test任务，搜索添加Visual Studio Test任务，指定测试项目生成的dll路径即可执行测试。

• 如果还是提示找不到.NET Framework 4.7.2相关引用，先检查Agent池是否选成了Linux/macOS，非Windows系统Agent天生不支持传统.NET Framework项目构建
• 如果依然提示找不到targets文件，打开Visual Studio Build任务的高级配置项，手动指定MSBuild路径为Visual Studio安装目录下的程序，比如C:\Program Files\Microsoft Visual Studio\2022\Enterprise\MSBuild\Current\Bin\MSBuild.exe，不要选择.NET Core SDK目录下的MSBuild
• 如果依赖还原失败，确认用的是原生NuGet restore任务，dotnet restore无法正确还原传统.NET Framework项目packages.config格式管理的依赖。

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