C++ 调用 .NET DLL 时,同名依赖的不同版本为何可能引发异常?
结论
仅凭这些日志,无法判断同事的说法是否正确,也无法确认程序已经安全地从旧版切换到新版。日志没有证明 CLR 执行了“发现更新版本后替换旧版本”的操作,EEMessageException 这一行也不足以确定异常原因。
两个目录中有同名 DLL,本身不一定出错。需要确认调用方请求的程序集身份、CLR 最终绑定的程序集,以及该程序集所属的 AssemblyLoadContext。
为什么不同版本可能发生冲突?
.NET 8 使用 AssemblyLoadContext 管理程序集加载。同一个 AssemblyLoadContext 对每个程序集简单名称只能加载一个版本。解析依赖时,如果同名程序集已经加载,只有已加载版本不低于请求版本,才能满足版本解析条件。满足这个条件也不保证 API 兼容。AssemblyLoadContext 版本规则
例如,假设实际的 AssemblyVersion 分别为 8.0.0.0 和 10.0.0.0:
- 如果当前上下文已经加载
8.0.0.0,它就不能满足后续对10.0.0.0的请求。 - 如果先加载
10.0.0.0,它可能满足较低版本的引用,但仍需确认调用方需要的类型和方法是否兼容。
这里的版本不能直接用文件属性中的 File Version 代替。还要区分 NuGet 包版本、AssemblyVersion 和目标框架。文件版本显示 10.x,不能单独证明它必须运行在 .NET 10 上。
程序集解析没有“遍历所有目录,始终挑选最新 DLL”的通用规则。默认探测受宿主提供的路径和依赖信息影响。默认依赖探测规则
Unloaded 是否意味着 DLL 真正卸载?
这些消息带有 (Win32) 标记,反映的是本机模块调试信息。Windows 的 DLL 卸载调试事件表示相应的 DLL 模块被卸载,因此笼统地说“Unloaded 不代表卸载”并不准确。Windows DLL 卸载调试事件
本机模块事件不能直接证明托管程序集已经完成绑定、被业务代码使用,然后又被 CLR 替换。探测或检查过程中是否发生了临时映射,可以作为排查方向;现有日志不足以确认具体过程。
托管程序集的卸载另有规则。.NET 支持通过可回收的 AssemblyLoadContext 卸载一组程序集,前提是相关引用和执行中的代码不再阻止回收。默认上下文中的程序集不能像普通本机 DLL 一样随意卸载,再换成另一个版本。程序集卸载机制
应该如何排查?
1. 读取两个文件的程序集身份
可以在 PowerShell 中检查文件,不必先运行其中的业务代码:
$paths = @(
'C:\Program Files (x86)\dotnet\shared\Microsoft.AspNetCore.App\8.0.21\Microsoft.Extensions.Logging.Abstractions.dll',
'C:\Program Files (x86)\Own_Company\Own_Product\Microsoft.Extensions.Logging.Abstractions.dll'
)
foreach ($path in $paths) {
$identity = [System.Reflection.AssemblyName]::GetAssemblyName($path)
[pscustomobject]@{
Path = $path
AssemblyIdentity = $identity.FullName
FileVersion = (Get-Item -LiteralPath $path).VersionInfo.FileVersion
}
}
再检查 Own_DLL 及其托管依赖的引用元数据,确认是谁请求了哪个版本。只比较这两个文件的属性,无法知道请求方的实际要求。
2. 确认进程中实际加载的程序集
如果能够修改托管层,可以在出错前执行以下 C# 诊断代码:
using System;
using System.Runtime.Loader;
foreach (var context in AssemblyLoadContext.All)
{
foreach (var assembly in context.Assemblies)
{
if (assembly.GetName().Name ==
"Microsoft.Extensions.Logging.Abstractions")
{
Console.WriteLine($"Context: {context.Name}");
Console.WriteLine($"Identity: {assembly.FullName}");
Console.WriteLine($"Location: {assembly.Location}");
}
}
}
这段代码只查看当前已加载的程序集,不会主动加载目标 DLL。如果失败时加载尚未完成,列表中可能没有目标程序集,需要继续查看加载事件。
3. 获取完整异常和加载记录
EEMessageException、EEFileLoadException 这样的调试器显示名称不能替代完整的托管异常信息。应在异常发生时记录异常消息、HRESULT、调用栈、InnerException,以及涉及的程序集名称和路径,并确认异常是否最终未被处理。
对于 .NET 8 宿主,可以在新的命令提示符会话中启用宿主跟踪,然后启动程序:
set COREHOST_TRACE=1
set COREHOST_TRACE_VERBOSITY=4
set COREHOST_TRACEFILE=%TEMP%\Own_Product-host-trace.txt
Current_Program.exe
需要从程序所在目录运行,或使用 EXE 的完整路径。这类跟踪可用于检查宿主启动和依赖解析信息;.NET 8 使用 COREHOST_ 前缀。宿主跟踪环境变量
如果需要查看托管程序集的加载事件,可以在已安装 dotnet-trace、且目标运行时允许诊断连接的环境中执行以下命令,将 <pid> 替换为实际进程 ID:
dotnet-trace collect --providers Microsoft-Windows-DotNETRuntime:4 --process-id <pid>
连接后再触发出错调用,检查请求的程序集、解析阶段和结果。收集程序集加载事件
两个 JSON 文件分别应该检查什么?
ijwhost.dll 的存在提示这里可能使用了 C++/CLI,但仍应以项目配置为准。如果确实是面向 .NET 8 的 C++/CLI DLL,它会加载到默认 AssemblyLoadContext。从本机入口首次启动托管代码时,需要为相应组件提供运行时配置;如果运行时已由托管入口启动,则使用入口的配置。C++/CLI 的运行时配置与加载上下文
检查文件时应区分:
Own_DLL.runtimeconfig.json:检查目标框架、框架名称、版本要求和适用的运行时选择设置。它不提供针对任意依赖 DLL 的“始终使用最高版本”开关。Own_DLL.prep.json:目前没有文件内容,也不知道它由哪个工具生成,无法确认它是否参与加载。应核对实际文件名和读取它的组件。*.deps.json:这是 .NET 常见的依赖描述文件,宿主可以据此构建探测信息。需要检查启动链实际使用了哪些文件,不能自动把prep.json当成deps.json。依赖描述与探测路径
如何处理 8.x 与 10.x 并存的部署?
修复方式取决于确认后的依赖要求。
- 如果整个产品可以使用兼容的 8.x 依赖,将相关项目的直接引用和传递依赖统一到选定版本,重新构建并部署完整输出。确认没有组件需要更高版本后,再清理产品目录中的遗留文件。
- 如果某个组件确实需要 10.x,检查具体包提供的目标框架资产和完整依赖集合,再调整构建与部署。只复制一个较新的
Microsoft.Extensions.Logging.Abstractions.dll,不能保证依赖解析成功。 - 如果不同组件必须使用不兼容版本,可以考虑隔离。纯托管插件可以设计独立的
AssemblyLoadContext,但跨上下文传递的接口需要共享同一程序集实例。对于这里可能存在的 .NET 8 C++/CLI 入口,不能假设增加自定义上下文就能改变它的默认加载行为;必要时可以使用独立进程隔离依赖。
不要直接替换 dotnet\shared 中的 DLL。应通过产品的项目引用、依赖描述和部署输出解决版本选择问题。.NET Framework 的 bindingRedirect 也不是 .NET 8 的通用解决方案。
还需要补齐完整异常信息、实际程序集身份,以及启动链使用的配置文件内容。有了这些信息,才能判断应该统一到 8.x、保留兼容的 10.x,还是修复另一项加载配置。
备注:内容仅供参考。
