.NET Core 5.0中iText与BouncyCastle类型绑定冲突解决求助

针对你遇到的CS0433类型冲突问题，以下是几个可行的解决思路：

1. 为所有相关程序集设置别名并在代码中显式区分 #

别名不仅要给直接引用的iText7适配器设置，还需要处理间接引用的原版BouncyCastle.NetCore，步骤如下：

• 编辑项目的.csproj文件，为两个BouncyCastle相关的程序集添加别名：

<ItemGroup>
  <!-- 给iText的FIPS适配器程序集设置别名 -->
  <PackageReference Include="itext7.bouncy-castle-fips-adapter" Version="8.0.4">
    <Aliases>iTextBCFIPS</Aliases>
  </PackageReference>
  <!-- 为间接引用的冲突程序集强制指定别名 -->
  <AssemblyAlias AssemblyName="BouncyCastle.Crypto, Version=1.8.6.0" Alias="OriginalBC" />
  <AssemblyAlias AssemblyName="bc-fips-1.0.2, Version=1.0.2.0" Alias="iTextBCFIPS" />
</ItemGroup>

• 在代码文件顶部添加extern alias声明，明确指定使用哪个别名下的类型：

extern alias iTextBCFIPS;
extern alias OriginalBC;

// 按需引用对应别名下的命名空间
using ITextCrypto = iTextBCFIPS::Org.BouncyCastle.Crypto;
using OriginalCrypto = OriginalBC::Org.BouncyCastle.Crypto;

// 使用时明确指定类型所属的命名空间
var itextHashSet = new ITextCrypto.HashSet();
var originalHashSet = new OriginalCrypto.HashSet();

2. 通过类库隔离冲突程序集 #

将依赖不同BouncyCastle的逻辑拆分到独立的类库项目中，避免在同一个项目中直接引用冲突的程序集：

• 创建类库A：仅引用itext7.bouncy-castle-fips-adapter，封装PDF/TIFF处理的所有逻辑，内部处理类型引用。
• 创建类库B：仅引用依赖原版BouncyCastle.NetCore的第三方库，封装对应业务逻辑。
• 主项目仅引用类库A和类库B，此时主项目不会直接加载两个冲突的BouncyCastle程序集，从而避免类型冲突。

3. 尝试程序集绑定重定向（谨慎使用） #

.NET Core中可通过配置绑定重定向强制使用某一个版本的BouncyCastle程序集，但此方法可能导致其中一个闭源库因版本不兼容失效，需测试验证：

• 在.csproj中启用自动生成绑定重定向：

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

• 编译后，在输出目录找到生成的[项目名].runtimeconfig.json，添加绑定重定向规则：

{
  "runtimeOptions": {
    "assemblyBinding": {
      "dependencies": [
        {
          "name": "BouncyCastle.Crypto",
          "publicKeyToken": "0e99375e54769942",
          "redirects": [
            {
              "from": "1.0.2.0",
              "to": "1.8.6.0"
            }
          ]
        }
      ]
    }
  }
}

注意：需替换publicKeyToken为对应程序集的公钥令牌，可通过反编译工具查看。

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