ASP.NET Core 7中BouncyCastle版本冲突：绑定重定向无效问题排查

一、绑定重定向失效的核心原因 #

• .NET Core与Framework的机制差异：ASP.NET Core默认不自动处理程序集绑定重定向，且runtimeconfig.template.json的配置规则和.NET Framework的app.config不同，若配置格式或程序集标识不匹配，重定向完全不会生效。
• 程序集标识不匹配：Portable.BouncyCastle v1.8.5和BouncyCastle.NetCore v2.2.1的BouncyCastle.Crypto程序集，可能存在强名称、公钥令牌的差异，导致重定向规则无法匹配目标程序集。
• 第三方库的强制加载逻辑：Yoti v3.17.0可能通过硬编码路径、强名称绑定等方式，强制加载旧版本Portable.BouncyCastle，绕过了绑定重定向机制。
• 输出目录的旧程序集残留：若旧版本BouncyCastle.Crypto.dll仍被复制到输出目录，运行时会优先加载本地文件，忽略重定向配置。

二、可行的解决办法 #

1. 彻底排除旧依赖并统一新版本 #

在项目的.csproj文件中，给Yoti添加依赖排除规则，同时显式锁定BouncyCastle.NetCore v2.2.1：

<PackageReference Include="Yoti" Version="3.17.0">
  <ExcludeAssets>Portable.BouncyCastle</ExcludeAssets>
</PackageReference>
<PackageReference Include="BouncyCastle.NetCore" Version="2.2.1" PrivateAssets="all" />

同时添加规则阻止旧程序集复制到输出目录：

<ItemGroup>
  <None Include="BouncyCastle.Crypto.dll" Condition="Exists('BouncyCastle.Crypto.dll')">
    <CopyToOutputDirectory>Never</CopyToOutputDirectory>
  </None>
</ItemGroup>

2. 配置正确的runtimeconfig.template.json重定向 #

确保重定向规则匹配程序集的完整标识（包括公钥令牌，可通过ildasm工具查看）：

{
  "runtimeOptions": {
    "assemblyBinding": {
      "dependencies": [
        {
          "name": "BouncyCastle.Crypto",
          "publicKeyToken": "0e99375e54769942", // 替换为实际公钥令牌
          "redirects": [
            {
              "oldVersion": "0.0.0.0-1.8.5.0",
              "newVersion": "2.2.1.0"
            }
          ]
        }
      ]
    }
  }
}

3. 自定义程序集解析逻辑 #

在Program.cs入口处添加AssemblyResolve事件，强制加载新版本程序集：

using System.Reflection;

var builder = WebApplication.CreateBuilder(args);

AppDomain.CurrentDomain.AssemblyResolve += (sender, args) =>
{
    var assemblyName = new AssemblyName(args.Name);
    if (assemblyName.Name.Equals("BouncyCastle.Crypto", StringComparison.OrdinalIgnoreCase))
    {
        var targetPath = Path.Combine(AppContext.BaseDirectory, "BouncyCastle.Crypto.dll");
        return File.Exists(targetPath) ? Assembly.LoadFrom(targetPath) : null;
    }
    return null;
};

// 后续应用配置...
var app = builder.Build();
// ...

4. 检查第三方库兼容性 #

确认Yoti v3.17.0是否兼容BouncyCastle.NetCore v2.2.1：若Yoti仅使用了旧版本的通用API，升级后可正常运行；若依赖旧版本特定API，需尝试升级Yoti到更高版本（优先选择已更新依赖的版本）。

5. 启用程序集绑定日志排查 #

通过环境变量启用绑定日志，定位具体加载失败原因：

# Windows
set COREHOST_TRACE=1
set COREHOST_TRACEFILE=assembly_bind.log

# Linux/macOS
export COREHOST_TRACE=1
export COREHOST_TRACEFILE=assembly_bind.log

运行应用后查看日志，可明确是重定向规则不匹配、程序集缺失还是其他加载问题。

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