如何在独立部署的ASP.NET Core应用中解决DLL版本冲突？

你的假设验证 #

你的推测完全正确：独立部署模式下，dotnet publish会将指定的.NET Core runtime pack（此处为runtimepack.Microsoft.NETCore.App.Runtime.win-x64/6.0.16）打包到输出目录中，而该runtime pack内置了与.NET 6 runtime版本绑定的System.Text.Encoding.CodePages v6.0.0.0。由于runtime pack的依赖优先级高于项目直接引用的NuGet包，最终发布目录只会保留低版本DLL。

验证方式：

• 找到本地runtime pack的Manifest文件，路径通常为C:\Program Files\dotnet\packs\runtimepack.Microsoft.NETCore.App.Runtime.win-x64\6.0.16\data\Manifest.xml
• 打开文件搜索System.Text.Encoding.CodePages，可看到其被标记为v6.0.0.0版本，属于runtime pack的一部分

解决方案 #

方法1：通过PackageReference强制指定版本 #

在Project B（或启动项目Project A）的.csproj文件中，修改System.Text.Encoding.CodePages的引用，添加<Force>true</Force>属性，强制MSBuild优先使用指定的v7.0.0版本，覆盖runtime pack的低版本依赖：

<PackageReference Include="System.Text.Encoding.CodePages" Version="7.0.0">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
  <Force>true</Force>
</PackageReference>

修改后重新执行发布命令，发布目录将包含v7.0.0.0版本的DLL。

方法2：自动化复制指定版本DLL #

若方法1不生效，可在项目文件中添加发布后自动复制DLL的目标，替代手动操作：

<Target Name="CopyCodePagesDll" AfterTargets="Publish">
  <!-- NuGet包根目录可根据你的环境调整 -->
  <Copy 
    SourceFiles="$(NuGetPackageRoot)system.text.encoding.codepages\7.0.0\runtimes\win\lib\net6.0\System.Text.Encoding.CodePages.dll" 
    DestinationFolder="$(PublishDir)" 
    OverwriteReadOnlyFiles="true"
  />
</Target>

该目标会在发布完成后，自动从NuGet缓存中复制v7.0.0版本的DLL到发布目录，覆盖runtime pack带来的低版本文件。

方法3：调整Runtime Roll Forward策略（可选） #

若你愿意让应用在独立部署时使用更高版本的.NET runtime，可在项目文件中添加RollForward配置（仅在确认兼容时使用，此方法会改变整个应用的runtime版本）：

<PropertyGroup>
  <RollForward>LatestMinor</RollForward>
</PropertyGroup>

配置后，独立部署时会使用与.NET 6兼容的最新minor版本runtime，其自带的CodePages版本可能更高，但此方法不如前两种直接针对单个包版本的控制精准。

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