.NET6项目中Microsoft.Net.Http.Headers版本冲突及HeaderNames.XFrameOptions兼容问题

合理解决方案 #

1. 显式引入指定版本的Microsoft.Net.Http.Headers包 #

在报错项目的.csproj文件中添加对Microsoft.Net.Http.Headers 6.0.0版本的显式引用，强制项目使用适配.NET6的版本，覆盖间接引入的旧版本：

<PackageReference Include="Microsoft.Net.Http.Headers" Version="6.0.0" />

添加后项目会优先加载指定的6.0.0版本，避免旧版本程序集干扰。

2. 更新引发冲突的间接依赖包 #

既然旧版本Microsoft.Net.Http.Headers是由Microsoft.AspNetCore.Http.Extensions/2.2.0间接引入的，直接将Microsoft.AspNetCore.Http.Extensions更新到.NET6适配的版本（如6.0.x系列），它会自动引入对应版本的Microsoft.Net.Http.Headers，从根源上解决版本冲突。

3. 启用集中包版本管理（Central Package Management） #

如果有多项目需要统一版本，在解决方案根目录创建Directory.Packages.props文件，统一指定依赖版本，确保所有项目使用相同的Microsoft.Net.Http.Headers版本：

<Project>
  <PropertyGroup>
    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
  </PropertyGroup>
  <ItemGroup>
    <PackageVersion Include="Microsoft.Net.Http.Headers" Version="6.0.0" />
  </ItemGroup>
</Project>

程序集解析问题的直接诊断方法 #

1. 查看完整依赖树 #

执行以下命令查看项目所有直接和间接依赖，快速定位旧版本Microsoft.Net.Http.Headers的来源：

dotnet list package --include-transitive

在输出中搜索Microsoft.Net.Http.Headers，即可看到它的引入路径和版本信息。

2. 查看构建详细日志 #

通过详细构建日志追踪程序集加载逻辑：

dotnet build -v detailed

在日志中搜索Microsoft.Net.Http.Headers，可以看到版本选择的具体过程和原因。

3. Visual Studio依赖项视图排查 #

在Visual Studio中打开报错项目的「依赖项」→「NuGet」节点，找到Microsoft.Net.Http.Headers，右键选择「查看依赖关系」，直观看到是哪个上层包引入了旧版本。

4. 程序集绑定日志查看器（Fuslogvw） #

Windows环境下，使用随.NET SDK安装的Fuslogvw.exe工具：开启程序集绑定日志后运行项目，可查看程序集加载的完整流程，包括版本选择的触发原因。

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