NHibernate版本升级后测试服务器部署遇程序集加载错误

排查与修复步骤 #

• 确认项目引用与NuGet包一致性
  检查所有关联项目的NHibernate引用，确保全部是4.1.2.4000版本，无3.3.1.4000残留。通过NuGet包管理器卸载旧版本，重新安装4.1.2.4000，同步更新所有依赖该包的子项目。
• 清理并重新生成完整部署包
  本地右键解决方案选择「清理」，再执行「重新生成所有项目」。部署时放弃增量发布，采用完整发布模式，避免服务器残留旧版本DLL文件。
• 配置程序集绑定重定向
  在Web.config/App.config中添加或更新绑定重定向规则，强制应用加载新版本NHibernate：

  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="NHibernate" publicKeyToken="aa95f207798dfdb4" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-4.1.2.4000" newVersion="4.1.2.4000" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
  

  注意验证publicKeyToken的正确性，可通过查看NHibernate.dll的属性确认公钥令牌。
• 清理服务器残留文件
  登录测试服务器，找到项目部署目录，删除所有旧版NHibernate.dll及相关依赖文件（如NHibernate.ByteCode.Castle等），再重新部署新版本文件。
• 检查第三方依赖兼容性
  若项目使用了依赖NHibernate的第三方库（如ORM扩展、缓存插件），确认这些库是否兼容4.1.2.4000版本。部分旧插件可能硬编码依赖旧版NHibernate，需同步升级此类依赖库。

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