无法为 .Net 标准库 (System.Text.Json) 加载程序集

Question

我正在编写一个将由二进制 PowerShell 模块使用的 .Net Standard 2.0 库。该库基本上是一个 API 客户端，其中包含许多用于处理 JSON 响应的类。在尝试反序列化字符串之前，我确认 API 提供的 JSON 编码字符串没有问题。

当使用 NuGet 包时，compatible 使用 .Net Standard 2.0，我想我会尝试切换到 System.Text.Json，而不是使用 NewtonSoft。但是，它似乎没有在某些平台上所需的特定程序集的版本。

我的环境：

Windows 10
PowerShell 5.1 桌面版
.Net 框架 4.8
PowerShell 核心 6.2.2
dotnet 3.0.100 版

在 PowerShell 桌面 上，当它必须反序列化任何内容时，我会遇到以下问题：

PS dir:\> Import-Module '.\file.dll'
PS dir:\> [namespace.class]::TestMethod($string, $anotherString)  # Test method to return string
{"attribute":"value"}
PS dir:\> [namespace.class]::Method($string, $anotherString)  # Same as above, but uses System.Text.Json to deserialise
Could not load file or assembly 'System.Buffers, Version=4.0.2.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51' or one of its dependencies. The system
cannot find the file specified.

# System.Buffers.dll is with the System.Text.Json package, but seems to be the wrong version
PS dir:\> (Get-Item .\System.Buffers.dll).VersionInfo.FileVersion
4.6.26515.06
PS dir:\> [System.Reflection.Assembly]::LoadFile("$pwd\System.Buffers.dll").GetName().Version

Major  Minor  Build  Revision
-----  -----  -----  --------
4      0      3      0

在 PowerShell Core 上，另一个程序集/文件存在相同的异常。

PS dir:\> Import-Module '.\file.dll'
PS dir:\> [namespace.class]::Method($string, $anotherString)
"Could not load file or assembly 'System.Text.Encodings.Web, Version=4.0.5.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51'. Could not find or load a specific file. (Exception from HRESULT: 0x80131621)"

#System.Text.Encodings.Web.dll is with the System.Text.Json package and appears to be the required version...
PS dir:\> (Get-Item .\System.Text.Encodings.Web.dll).VersionInfo.FileVersion
4.700.19.56404
[System.Reflection.Assembly]::LoadFile("$pwd\System.Text.Encodings.Web.dll").GetName().Version

Major  Minor  Build  Revision
-----  -----  -----  --------
4      0      5      0

有人对我如何在不切换到 Newtonsoft 的 JSON 包的情况下解决这个问题有任何建议吗？从 System.Text.Json 4.7.1 回退到 4.7.0 或 4.6.0 会引入其他程序集的问题，这些程序集是 System.Text.Json 的 NuGet 包的一部分。我已经阅读了here 的建议，但我在这里要么不能应用，要么就是不明白。

提前致谢。如果您需要更多信息，请告诉我，我会提供。

编辑

我按照 Gokhan 的建议更新了 csproj

<PropertyGroup>
  <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
  <GenerateBindingRedirectsOutputType>true</GenerateBindingRedirectsOutputType>
</PropertyGroup>

这在 appName.dll.config 中生成了以下代码

<runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="System.Runtime.CompilerServices.Unsafe" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-4.0.6.0" newVersion="4.0.6.0" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>

所以所有绑定重定向的自动生成都不起作用，如上所述，至少还有两个不起作用。我会尝试手动创建它们，但据我所知，现在没有源配置文件可以放入它们。如果有人对此有任何指导，我将不胜感激。

Answer 1

如果您找不到System.Buffers DLL 版本冲突的原因，我认为您可以在配置文件中使用assemblybinding 来使用版本4.0.3.0 而不是4.0.2.0

<runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="System.Buffers" publicKeyToken="cc7b13ffcd2ddd51"/>
        <bindingRedirect oldVersion="0.0.0.0-4.0.3.0" newVersion="4.0.3.0" />
      </dependentAssembly>
    </assemblyBinding>
 </runtime>

如果您有其他版本冲突，请删除配置文件中的所有dependentassembly标签（包括上述标签）并将其添加到项目（.csproj）文件中：

<PropertyGroup>
  <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
  <GenerateBindingRedirectsOutputType>true</GenerateBindingRedirectsOutputType>
</PropertyGroup>

当您构建项目时，您会在输出 bin 文件夹中看到 (WebAppName).dll.config 文件。将所有assemblybindings 从那里复制到您的源配置文件。然后从项目文件中删除上面的代码部分。

Answer 2

在 Visual Studio 中打开您的解决方案。检查所有 dll 的参考。你有来自 Bin 的重复 dll 和其他来自 nugget 包的 dll 吗？ 如果您拥有 Visual Studio 2017 版本 15.7 或更高版本，则可以在项目的属性页中轻松禁用自动生成的绑定重定向。

在解决方案资源管理器中右键单击项目并选择属性。

在应用程序页面上，取消选中自动生成绑定重定向选项。

按 Ctrl+S 保存更改。 尝试构建它。 检查您是否从 nugget 位置引用所有 Dll，并且 bin 文件夹中没有任何内容。 如果它构建你很好，否则再次绑定重定向编译。

Answer 3

您遇到的问题是因为您的库面向 .NET Standard，它不是一个可运行的框架，因此在尝试使用 Powershell 之类的模型加载它时有时会出现问题。让我试着解释一下发生了什么。

.NET Standard 只是一个 API 外围规范，因此基本上只是一组 API，它们将保证存在并能够在任何实现该版本 .NET Standard 的可运行框架上运行。这意味着，如果您有一个以 .NET Standard 为目标的库，则没有真正的方法可以以保证在任何可运行框架上运行的方式发布该库及其所有依赖项，因为每个可运行框架可能需要额外的依赖项让您的库正确加载。从控制台应用程序（通过项目引用或通过 NuGet 包）引用 .NET Standard 库时，控制台应用程序将知道它的目标是哪个可运行框架，因此它将能够获取您的库所需的正确依赖项集在运行时，但您的方案的问题是这个控制台应用程序并不真正存在，因为您是从 powershell 加载它（在某种意义上基本上是控制台应用程序）。由于所有这些，为了在运行时成功加载库，您必须执行引用库的控制台应用程序将执行的工作，并根据运行时选择正确的引用来携带库加载它。对于 powershell，基本上有两种可能的运行时（用于 powershell 核心的 .NET Core 和用于 Powershell 的 .NET Framework）。

解决您的问题的最简单方法是创建一个虚拟控制台应用程序：从命令提示符只需运行dotnet new console -n dummyConsoleApp，将目标框架设置为netcoreapp2.0（假设您在 powershell 核心上运行，如果您正在运行在完整的 powershell 上，然后将其设置为 net46)。然后将项目引用添加到您的库，如<ProjectReference Include="...<FullPathtoYourProject>\File.csproj" />，然后从命令提示符dotnet publish -r win-x64 运行，这应该在您的bin 文件夹中创建一个发布目录，该目录将包含您的应用程序将在运行时使用的所有程序集。之后，尝试再次加载您的 File.dll，但这次是从该发布文件夹加载，这次您应该成功了，因为该发布文件夹将具有运行 powershell 运行时所需的所有正确依赖项。如果由于某种原因这对您不起作用，请随时在https://github.com/dotnet/runtime repo 中记录有关此问题并标记我 (@joperezr)，我很乐意帮助您诊断和解决问题。