在.NET 中，bindingRedirect（程序集绑定重定向）和codeBase（程序集位置指定）是两种解决程序集加载问题的机制

在.NET 中，bindingRedirect（程序集绑定重定向）和codeBase（程序集位置指定）是两种解决程序集加载问题的机制，用途和场景不同，以下详细说明它们的区别、用法及结合使用的场景：

一、bindingRedirect：程序集版本重定向

作用

当应用程序引用的程序集版本与实际部署的版本不一致时，强制 CLR 加载指定的新版本（或旧版本），避免 “程序集版本不匹配” 异常。

适用场景

• 项目中多个依赖项引用同一程序集的不同版本（如 A 库依赖Newtonsoft.Json 10.0.0，B 库依赖12.0.0），需统一版本。
• 升级程序集后，无需修改代码引用，直接重定向到新版本。

• 配置示例

  <configuration>
    <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
        <dependentAssembly>
          <assemblyIdentity name="itextsharp" 
                            publicKeyToken="8354ae6d2174ddca" 
                            culture="neutral" />
          <!-- 将旧版本（0.0.0.0-5.0.4.0）重定向到5.0.5.0 -->
          <bindingRedirect oldVersion="0.0.0.0-5.0.4.0" 
                           newVersion="5.0.5.0" />
        </dependentAssembly>
      </assemblyBinding>
    </runtime>
  </configuration>

  关键说明

  • oldVersion：需要被重定向的版本范围（支持x.x.x.x-y.y.y.y格式）。
  • newVersion：目标版本（必须与部署的程序集版本一致）。
  • 需保证目标版本程序集存在于程序集搜索路径中（如输出目录、GAC）。

二、codeBase：指定程序集的具体位置

作用

告诉 CLR “某个版本的程序集在特定路径下”，用于程序集不在默认搜索路径（如输出目录、GAC）的情况。

适用场景

• 程序集部署在自定义目录（如C:\Libs\、网络共享目录、CDN）。
• 同一程序集的不同版本存放在不同路径，需按需加载。

配置示例

<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="itextsharp" 
                          publicKeyToken="8354ae6d2174ddca" 
                          culture="neutral" />
        <!-- 5.0.5.0版本的程序集在指定路径 -->
        <codeBase version="5.0.5.0" 
                  href="file:///C:/CustomLibs/itextsharp_5.0.5.0.dll" />
        <!-- 5.0.6.0版本的程序集在网络路径 -->
        <codeBase version="5.0.6.0" 
                  href="http://example.com/libs/itextsharp_5.0.6.0.dll" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
</configuration>

关键说明

• version：必须指定具体版本（不支持范围），且程序集需强命名（带公钥令牌）。
• href：支持本地路径（file:///）、HTTP 路径（http://）、UNC 路径（\\server\share\）。
• 若程序集在 GAC 中，codeBase会被忽略（GAC 优先级更高）。

三、结合使用：重定向 + 指定位置

场景

将旧版本重定向到新版本，同时新版本存放在自定义路径。

配置示例

<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="itextsharp" 
                          publicKeyToken="8354ae6d2174ddca" 
                          culture="neutral" />
        <!-- 旧版本重定向到5.0.5.0 -->
        <bindingRedirect oldVersion="0.0.0.0-5.0.4.0" 
                         newVersion="5.0.5.0" />
        <!-- 5.0.5.0版本的位置 -->
        <codeBase version="5.0.5.0" 
                  href="file:///C:/CustomLibs/itextsharp_5.0.5.0.dll" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
</configuration>

四、核心区别总结

特性	bindingRedirect	codeBase
作用	版本统一（重定向版本）	定位程序集（指定路径）
版本支持	支持版本范围（oldVersion）	仅支持具体版本（version）
依赖条件	目标版本需存在于搜索路径	程序集需强命名
优先级	先重定向版本，再按版本找位置	按版本匹配路径，无重定向功能

 

五、注意事项

1. 强命名要求：codeBase和bindingRedirect仅对强命名程序集生效（带publicKeyToken）。
2. 路径有效性：codeBase的href路径需保证程序运行时可访问（如权限、网络可达）。
3. GAC 优先级：若程序集已安装到 GAC，CLR 会优先加载 GAC 中的版本，忽略codeBase。
4. 配置位置：ASP.NET项目需配置在web.config，桌面程序配置在app.config（编译后为xxx.exe.config）。

根据你的需求选择合适的机制：需统一版本用bindingRedirect，需指定自定义路径用codeBase，两者结合可解决复杂的程序集加载问题。