多目标net48/net5.0项目构建出现框架不兼容报错如何解决

问题根因 #

该报错由MSBuild多框架全局构建时的目标框架匹配逻辑误判导致：单独指定单框架构建时，MSBuild会自动为依赖项目选择兼容的目标版本；多框架同时构建时，MSBuild错误选中了依赖项目的非兼容目标版本触发冲突。

解决步骤 #

• 排查依赖项目的目标框架条件限制
  打开依赖项目someProject.csproj，确认<TargetFrameworks>节点没有附加不必要的条件规则（例如限定配置、平台才生效的条件），确保配置全局生效：

  <PropertyGroup>
      <TargetFrameworks>net48;net5.0</TargetFrameworks>
  </PropertyGroup>
  

• 给项目引用添加显式框架绑定
  在主项目的<ProjectReference>节点中添加SetTargetFramework属性，强制主项目每个目标框架构建时，依赖项目使用相同的目标版本，配置示例如下：

  <ProjectReference Include="..\someProject.csproj" SetTargetFramework="TargetFramework=$(TargetFramework)" />
  

• 清理构建缓存重试
  1. 删除所有项目根目录下的bin、obj文件夹
  2. 执行命令dotnet clean清理解决方案级构建缓存
  3. 重新执行dotnet build验证构建结果
• 可选排查：检查全局构建配置
  确认解决方案根目录的Directory.Build.props、Directory.Build.targets文件中没有覆盖子项目目标框架的规则，若存在对应规则调整为不干涉多目标配置即可。

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