多TargetFrameworks项目编译.NET 8时依赖配置未生效的问题

问题分析 #

你配置了多目标框架并按框架指定不同版本的System.Text.Json依赖，但编译.NET 8时仍出现.NET 6依赖版本的警告，大概率是MSBuild对条件ItemGroup的解析优先级问题，或是旧缓存干扰了依赖解析。

解决方案 #

1. 改用MSBuild推荐的Choose/When分支配置 #

替换原有的条件ItemGroup为以下结构，这种方式能更明确地隔离不同框架的依赖配置，避免解析歧义：

<Choose>
  <When Condition="'$(TargetFramework)' == 'net6.0'">
    <ItemGroup>
      <PackageReference Include="System.Text.Json" Version="6.0.13" />
    </ItemGroup>
  </When>
  <When Condition="'$(TargetFramework)' == 'net8.0'">
    <ItemGroup>
      <PackageReference Include="System.Text.Json" Version="8.0.5" />
    </ItemGroup>
  </When>
</Choose>

2. 清理项目缓存并重新恢复依赖 #

执行以下命令清除旧的编译缓存和NuGet依赖缓存，确保依赖重新解析：

dotnet clean
dotnet restore -f net8.0

3. 重新发布项目 #

dotnet publish -f net8.0

额外提示 #

如果你的项目是应用程序类型（如ASP.NET Core Web API、控制台应用），.NET 6和.NET 8的SDK已经内置了System.Text.Json，无需单独添加PackageReference，直接移除对应引用即可消除警告。只有类库项目才需要显式引用该包。

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