Azure Pipeline：同一构建管道兼容ASP.NET与.NET Core项目问询

核心结论 #

完全可以在同一构建管道中同时构建传统ASP.NET（.NET Framework）和.NET Core项目，问题出在构建任务的配置逻辑与项目依赖的适配性上。

错误原因分析 #

你遇到的System.Data.Entity不存在的错误，本质是两类项目的依赖体系差异：

• 传统ASP.NET项目基于.NET Framework，System.Data.Entity是框架自带的组件；
• .NET Core项目不包含该组件，需通过NuGet引入Entity Framework Core（Microsoft.EntityFrameworkCore系列包）。
  Visual Studio能正常构建，是因为它会针对每个项目的目标框架自动处理依赖还原与构建逻辑，但旧的ASP.NET构建管道通常只适配.NET Framework项目，未正确处理.NET Core项目的依赖和构建流程。

具体实现方案 #

方案1：拆分构建任务，分别处理两类项目 #

在构建管道中添加两个独立步骤，适配不同框架的项目：

• 针对传统ASP.NET项目：使用MSBuild任务（或命令行msbuild），指定项目对应的.NET Framework版本，示例：

  msbuild YourAspNetProject.csproj /p:Configuration=Release /p:TargetFramework=net472
  

  也可指定解决方案中所有.NET Framework项目：

  msbuild YourSolution.sln /t:Build /p:Configuration=Release /p:Platform="Any CPU" /p:TargetFramework=net472
  

• 针对.NET Core项目：使用DotNetCoreCLI任务（或命令行dotnet命令），先还原依赖再构建：

  dotnet restore YourNetCoreProject.csproj
  dotnet build YourNetCoreProject.csproj --configuration Release
  

方案2：调整解决方案级构建的MSBuild参数 #

若希望继续通过.sln文件构建整个解决方案，需确保构建管道使用MSBuild 16.0+（对应Visual Studio 2019及以上版本），它支持混合框架解决方案的构建，执行以下步骤：

1. 先还原所有项目的依赖：

   msbuild YourSolution.sln /t:Restore /p:RestorePackagesConfig=true /p:RestoreProjectStyle=Both
   

2. 再执行解决方案构建：

   msbuild YourSolution.sln /p:Configuration=Release /p:Platform="Any CPU"
   

方案3：修复.NET Core项目的依赖错误 #

检查你的.NET Core项目，确保没有错误引用.NET Framework专属组件：

• 卸载项目中可能存在的System.Data.Entity引用；
• 通过NuGet安装对应版本的Microsoft.EntityFrameworkCore、Microsoft.EntityFrameworkCore.SqlServer（或其他数据库驱动包）；
• 替换代码中的命名空间：将using System.Data.Entity;改为using Microsoft.EntityFrameworkCore;，并调整EF相关API（比如DbContext的配置、查询写法等）。

长期理想解决方案 #

如果团队资源允许，建议逐步将传统ASP.NET项目迁移到.NET Core/.NET 5+，统一技术栈后，不仅能消除构建管道的适配问题，还能享受.NET Core的性能、跨平台等优势，降低长期维护成本。

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