.NET项目指定net5.0构建却要求Microsoft.NETCore.App 3.1.0

问题概述 #

从未接触过C#/.NET开发，因爱好项目需求，两天前开始将一个.NET项目从版本2升级到net5.0。本地环境为Ubuntu 22.04，通过snap安装了microsoft.net.sdk 8.0.300；Azure Pipeline使用windows-2019代理构建代码。项目可成功执行dotnet restore，但构建时失败，提示需要框架Microsoft.NETCore.App version 3.1.0，但项目已明确指定<TargetFramework>net5.0</TargetFramework>。已核对所有NuGet包均兼容net5.0，尝试多种包版本组合仍无法解决问题。

排查与解决思路 #

1. 检查项目的直接/间接依赖 #

• 确认解决方案内是否存在子项目仍以.NET Core 3.1为目标框架，或引用了未升级的3.1类库。主项目构建时会继承子项目的运行时依赖，导致触发3.1.0的需求。
• 执行dotnet list package --include-transitive命令，查看所有间接依赖，排查是否有包内部依赖.NET Core 3.1的运行时组件。

2. 明确Azure Pipeline的.NET SDK版本 #

• windows-2019代理默认可能包含多版本SDK，但需指定兼容net5.0的版本（推荐5.0.x系列）。在Pipeline YAML中添加SDK安装步骤：

- task: UseDotNet@2
  inputs:
    packageType: 'sdk'
    version: '5.0.x'
    installationPath: $(Agent.ToolsDirectory)/dotnet

• 若坚持使用.NET 8 SDK，需设置环境变量允许向前兼容：

- script: dotnet build YourProject.csproj --configuration Release
  env:
    DOTNET_ROLL_FORWARD: LatestMajor

3. 清理项目文件中的强制框架配置 #

• 检查项目csproj文件，确认是否存在<RuntimeFrameworkVersion>、<TargetLatestRuntimePatch>等强制指定运行时版本的配置，若有则删除或修改为net5.0对应的版本。
• 尝试注释<PublishWithAspNetCoreTargetManifest>等可能影响运行时依赖的配置后重新构建。

4. 清理构建缓存 #

• 本地执行dotnet clean，手动删除bin、obj目录后，重新执行dotnet restore和dotnet build。
• 在Azure Pipeline中启用增量构建禁用选项：

- task: DotNetCoreCLI@2
  inputs:
    command: 'build'
    projects: '**/*.csproj'
    arguments: '--configuration Release --no-incremental'

5. 临时补充.NET Core 3.1运行时（测试用） #

• 在Azure Pipeline中添加安装.NET Core 3.1运行时的步骤，验证是否为隐藏依赖导致：

- task: UseDotNet@2
  inputs:
    packageType: 'runtime'
    version: '3.1.x'

若安装后构建成功，需进一步追踪依赖链找到触发3.1依赖的根源包。

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