从C++CLI工程的依赖库引用问题看.Net加载程序集机制

Posted on by hackdl

问题

最近在为某第三方MFC项目写C++/CLI工程插件时遇到了如下一个问题：
MFC的工程不允许把.Net的依赖程序集放到执行程序的目录（防止影响其稳定性），依赖库只能放到非执行程序子目录的其他目录中。但无论是调用

// 使用windows API 需要 #include 
SetDllDirectory(L"PathToDll");
// 使用.Net API的CLI写法
System::Domain::CurrentDom服务器托管网ain->AppendPrivatePath(L"PathToDll");

或者加到PATH环境变量中，均无法加载依赖的第三方引用库。

问题处理方案

最终通过使用AssemblyResolve事件来手动加载程序集解决了该问题，参见参考链接1.

解答

这个问题的出现是因为不了解.Net的程序集的搜索与加载机制。C++/CLI的dll加载.Net依赖库时是完全按照.Net机制进行的，而.Net对程序集的加载顺序与搜索，有其自己的机制，在其官方文档中有详细描述（参考链接2）。简单来说按如下顺序。

加载顺序

  1. 根据App.Config或者发布者策略文件或者机器配置文件（这三个文件语法相同，位置不一样）中的决定依赖的程序集的版本号信息。
  2. 检查以前是否加载过该程序集，如果有直接加载，如果有失败记录直接失败。
  3. 针对强签名的程序集检查GAC中是否包含，有就直接加载。
  4. 根据已经读取的配置信息开始进行程序集的探测。

程序集的探测

  1. 如果配置文件没有对程序集的相关描述，且程序集的加载请求是通过Assembly.LoadFrom(“path”)发起的，则会直接根据指定的路径加载。
  2. 如果配置文件配置了节点则会直接按指定的相对路径或URL加载。找不到则直接失败。官方文档
  1. 如果有节点的话，则会通过子目录查找加载，注意只允许相对目录或URL，这里其实和AppendPrivatePath或者AppDomainSetup.PrivateBinPath都是一回事。官方文档

注意在probling的过程中，有其相应的规则。受基目录，语言，程序集名称，和节点配置（注意这里不止App.Config还有另外两个配置文件）相关。

官方举例如下：

  • 程序集: myAssembly
  • 基目录: http://www.code.microsoft.com
  • [节点配置: bin
  • 语言: de
    那么运行时会从以下四个URL尝试搜索加载：
  • http://www.code.microsoft.com/de/myAssembly.dll
  • http://www.code.microsoft.com/de/myAssembly/myAssembly.dll
  • http://www.code.microsoft.com/bin/de/myAssembly.dll
  • http://www.code.microsoft.com/bin/de/myAssembly/myAssembly.dll

注意事项

  1. 可以使用probing工具进行检查尝试的probling的路径Fuslogvw.exe (Assembly Binding Log Viewer) – .NET Framework | Microsoft Learn（需要管理员权限启动，下面会给出一个例子）。
  2. 只有强签名的程序集才有版本号检查。
  3. 子目录内的应用程序集不会主动搜索加载，需要在包括在privatePath的内。
  4. 不管还是节点的描述都不允许脱离执行应用程序根目录，以下一个Fuslogvw.exe工具提供的日志说明了这一点。配置文件中使用来指定了appbase目录外的Ref1目录作为搜索目录。但拼接出来的路径警告: 不是探测位置。最终加载失败。
*** 程序集联编程序日志项 (1/13/2024 @ 12:06:12 PM) ***

操作失败。
绑定结果: hr = 0x80070002。系统找不到指定的文件。

程序集管理器加载位置:  C:WindowsMicrosoft.NETFrameworkv4.0.30319clr.dll
在可执行文件下运行  C:Users服务器托管网zhangDesktopmyprojectAssemblyLoadDemooutputconsoleDemoConsoleApp.exe
--- 详细的错误日志如下。

=== 预绑定状态信息 ===
日志: DisplayName = AssemblyRef, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null
 (Fully-specified)
日志: Appbase = file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/console/
日志: 初始 PrivatePath = NULL
日志: 动态基 = NULL
日志: 缓存基 = NULL
日志: AppName = DemoConsoleApp.exe
调用程序集: DemoConsoleApp, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null。
===
日志: 此绑定从 default 加载上下文开始。
日志: 在配置文件中找到专用路径提示: ..Ref1。
日志: 正在使用应用程序配置文件: C:UserszhangDesktopmyprojectAssemblyLoadDemooutputconsoleDemoConsoleApp.exe.Config
日志: 使用主机配置文件: 
日志: 使用 C:WindowsMicrosoft.NETFrameworkv4.0.30319configmachine.config 的计算机配置文件。
日志: 此时没有为引用应用策略(私有、自定义、分部或基于位置的程序集绑定)。
警告: 不是探测位置 file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/Ref1/AssemblyRef.DLL，因为该位置在 appbase 范围以外。
警告: 不是探测位置 file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/Ref1/AssemblyRef/AssemblyRef.DLL，因为该位置在 appbase 范围以外。
警告: 不是探测位置 file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/Ref1/AssemblyRef.EXE，因为该位置在 appbase 范围以外。
警告: 不是探测位置 file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/Ref1/AssemblyRef/AssemblyRef.EXE，因为该位置在 appbase 范围以外。
日志: 尝试下载新的 URL file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/console/AssemblyRef.DLL。
日志: 尝试下载新的 URL file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/console/AssemblyRef/AssemblyRef.DLL。
日志: 尝试下载新的 URL file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/console/AssemblyRef.EXE。
日志: 尝试下载新的 URL file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/console/AssemblyRef/AssemblyRef.EXE。
日志: 已尝试所有探测 URLs 但全部失败。

*** 程序集联编程序日志项 (1/13/2024 @ 12:06:12 PM) ***

操作失败。
绑定结果: hr = 0x80070002。系统找不到指定的文件。

程序集管理器加载位置:  C:WindowsMicrosoft.NETFrameworkv4.0.30319clr.dll
在可执行文件下运行  C:UserszhangDesktopmyprojectAssemblyLoadDemooutputconsoleDemoConsoleApp.exe
--- 详细的错误日志如下。

=== 预绑定状态信息 ===
日志: DisplayName = AssemblyRef, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null
 (Fully-specified)
日志: Appbase = file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/console/
日志: 初始 PrivatePath = NULL
日志: 动态基 = NULL
日志: 缓存基 = NULL
日志: AppName = DemoConsoleApp.exe
调用程序集: DemoConsoleApp, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null。
===
日志: 此绑定从 default 加载上下文开始。
日志: 在配置文件中找到专用路径提示: ..Ref1。
日志: 正在使用应用程序配置文件: C:UserszhangDesktopmyprojectAssemblyLoadDemooutputconsoleDemoConsoleApp.exe.Config
日志: 使用主机配置文件: 
日志: 使用 C:WindowsMicrosoft.NETFrameworkv4.0.30319configmachine.config 的计算机配置文件。
日志: 此时没有为引用应用策略(私有、自定义、分部或基于位置的程序集绑定)。
警告: 不是探测位置 file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/Ref1/AssemblyRef.DLL，因为该位置在 appbase 范围以外。
警告: 不是探测位置 file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/Ref1/AssemblyRef/AssemblyRef.DLL，因为该位置在 appbase 范围以外。
警告: 不是探测位置 file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/Ref1/AssemblyRef.EXE，因为该位置在 appbase 范围以外。
警告: 不是探测位置 file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/Ref1/AssemblyRef/AssemblyRef.EXE，因为该位置在 appbase 范围以外。
日志: 尝试下载新的 URL file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/console/AssemblyRef.DLL。
日志: 尝试下载新的 URL file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/console/AssemblyRef/AssemblyRef.DLL。
日志: 尝试下载新的 URL file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/console/AssemblyRef.EXE。
日志: 尝试下载新的 URL file:///C:/Users/zhang/Desktop/myproject/AssemblyLoadDemo/output/console/AssemblyRef/AssemblyRef.EXE。
日志: 已尝试所有探测 URLs 但全部失败。
  1. 如果程序集有多个不同的版本号的版本的话，使用而不是。

参考链接：

  1. DLL redirection for c++/cli which load C# DLL (help) (microsoft.com)
  2. How the Runtime Locates Assemblies – .NET Framework | Microsoft Learn

服务器托管，北京服务器托管，服务器租用 http://www.fwqtg.net
机房租用，北京机房租用，IDC机房托管， http://www.fwqtg.net

相关推荐: spring开发之个微机器人二次开发

请求URL： http://域名地址/sendVideo 请求方式： POST 请求头Headers： Content-Type：application/json Authorization：login接口返回 参数： 参数名 必选 类型 说明 wId 是 s…

服务器托管，北京服务器托管，服务器租用，机房机柜带宽租用

服务器托管

咨询：董先生

电话13051898268 QQ/微信93663045！

上一篇:
下一篇: