.NET6.0项目Azure DevOps构建报NETSDK1005，如何排查依赖的netcoreapp2.1需求？

问题背景 #

本地Visual Studio 2022构建正常的.NET 6.0解决方案，所有项目目标框架配置如下：

<PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
</PropertyGroup>

但Azure DevOps流水线使用NuGet工具安装器5.8.0、NuGet restore、VS2022构建任务时，报错：

##[error]C:\Program Files\dotnet\sdk\6.0.403\Sdks\Microsoft.NET.Sdk\targets\Microsoft.PackageDependencyResolution.targets(267,5): Error NETSDK1005: Assets file 'C:\Agent3\_work\142\s\*****\obj\project.assets.json' doesn't have a target for 'netcoreapp2.1'. Ensure that restore has run and that you have included 'netcoreapp2.1' in the TargetFrameworks for your project. 
C:\Program Files\dotnet\sdk\6.0.403\Sdks\Microsoft.NET.Sdk\targets\Microsoft.PackageDependencyResolution.targets(267,5): error NETSDK1005: Assets file 'C:\Agent3\_work\142\s\*****\obj\project.assets.json' doesn't have a target for 'netcoreapp2.1'. Ensure that restore has run and that you have included 'netcoreapp2.1' in the TargetFrameworks for your project. [C:\Agent3\_work\142\s\*****\*****.csproj]

需要找出依赖项中要求netcoreapp2.1的来源。

排查步骤 #

• 检查本地project.assets.json文件：找到本地项目obj\Debug\net6.0\project.assets.json，全局搜索netcoreapp2.1，定位对应的依赖包，查看该包的目标框架支持情况，确认是否仅兼容netcoreapp2.1且未适配.NET 6.0。
• 用dotnet命令分析依赖树：进入项目根目录执行命令，列出所有直接/间接依赖，筛选出关联netcoreapp2.1的包：

  dotnet list package --include-transitive
  dotnet list package --include-transitive | findstr /i "netcoreapp2.1"
  

• 核对NuGet还原差异：检查Azure DevOps流水线的NuGet源是否与本地一致；本地清空NuGet缓存后重新还原，看是否复现问题：

  dotnet nuget locals all --clear
  dotnet restore
  

• 检查项目隐藏配置：打开报错的.csproj文件，确认是否有条件性的TargetFramework配置，或导入的.props/.targets文件强制指定了netcoreapp2.1目标。
• 验证构建任务参数：确认VS Build任务的MSBuild arguments是否正确指定/p:TargetFramework=net6.0，NuGet Restore任务是否未错误设置旧框架目标。

总结 #

这类问题通常是某个直接/间接依赖包仅支持netcoreapp2.1，且无兼容.NET 6.0的版本，或构建过程被强制指定了旧目标框架。定位到问题依赖后，升级包版本或替换为兼容包即可解决。

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