.NET 5 动态加载DLL及依赖时EF缺失、接口未实现报错如何解决
.NET 5 Worker Service 动态加载带第三方依赖插件的解决方案
问题根因说明
- 接口类型不匹配:主程序与插件使用的公共接口(如
IDependencyInjectionHelper)如果来自不同的程序集实例,即使命名空间、方法定义完全一致,CLR也会判定为不同类型,触发「方法无实现」的异常。 - 插件依赖未自动加载:默认程序集加载逻辑只会加载目标dll本身,不会主动探测加载插件的第三方依赖(如Entity Framework Core),导致依赖缺失报错。
解决步骤
1. 抽离独立的公共接口程序集
将所有插件需要实现的公共接口单独封装为独立类库,确保主程序与所有插件共用同一套接口定义:
- 新建.NET 5类库项目(如命名为
Plugin.Abstractions),仅存放IDependencyInjectionHelper等公共契约,不引入任何业务逻辑或第三方依赖。 - 主程序和所有插件项目均引用该公共类库,插件引用时需在csproj中添加配置,避免公共接口程序集被随插件发布导致重复加载:
<ProjectReference Include="..\Plugin.Abstractions\Plugin.Abstractions.csproj"> <ExcludeAssets>runtime</ExcludeAssets> </ProjectReference>
2. 实现带依赖自动解析的插件加载逻辑
使用.NET Core 3.0+提供的AssemblyDependencyResolver配合自定义AssemblyLoadContext,自动读取插件的依赖配置并加载所需依赖,同时支持不同插件的依赖版本隔离:
首先定义可隔离的插件加载上下文:
using System.Reflection; using System.Runtime.Loader; class PluginLoadContext : AssemblyLoadContext { private readonly AssemblyDependencyResolver _resolver; public PluginLoadContext(string pluginPath) : base(isCollectible: true) { _resolver = new AssemblyDependencyResolver(pluginPath); } protected override Assembly Load(AssemblyName assemblyName) { // 公共接口从默认上下文加载,保证类型全局统一 if (assemblyName.Name == "Plugin.Abstractions") { return Default.LoadFromAssemblyName(assemblyName); } string assemblyPath = _resolver.ResolveAssemblyToPath(assemblyName); return assemblyPath != null ? LoadFromAssemblyPath(assemblyPath) : null; } protected override IntPtr LoadUnmanagedDll(string unmanagedDllName) { string libraryPath = _resolver.ResolveUnmanagedDllToPath(unmanagedDllName); return libraryPath != null ? LoadUnmanagedDllFromPath(libraryPath) : IntPtr.Zero; } }
然后使用该上下文加载插件:
// 替换为你的插件dll完整路径(需使用publish输出的完整目录下的dll,包含所有依赖和.deps.json文件) string pluginDllPath = @"C:\Plugins\TestDatabaseConsumer\TestDatabaseConsumer.dll"; var pluginContext = new PluginLoadContext(pluginDllPath); var pluginAssembly = pluginContext.LoadFromAssemblyName( new AssemblyName(Path.GetFileNameWithoutExtension(pluginDllPath))); // 查找并实例化注入配置类 var injectionHelperType = pluginAssembly.GetTypes() .FirstOrDefault(t => typeof(IDependencyInjectionHelper).IsAssignableFrom(t) && !t.IsAbstract && t.IsClass); if (injectionHelperType != null) { var helper = Activator.CreateInstance(injectionHelperType) as IDependencyInjectionHelper; helper?.SetupInjection(hostContext, services); }
3. 插件发布要求
插件发布时需执行dotnet publish命令,输出目录需包含以下文件:
- 插件本身的dll、pdb文件
- 插件所有依赖的第三方dll(如Entity Framework Core相关程序集)
- 插件生成的
.deps.json、.runtimeconfig.json文件,这两个文件是依赖解析器识别依赖的必要文件,不可缺失。
异常场景验证
- 接口未实现异常:确认主程序与插件引用的
Plugin.Abstractions版本完全一致,且插件publish输出目录中不存在Plugin.Abstractions.dll文件即可解决。 - EF Core等依赖缺失异常:确认插件publish目录包含所有依赖文件,且加载逻辑使用了
AssemblyDependencyResolver进行依赖解析即可解决。
内容的提问来源于stack exchange,提问作者Don Chambers
相关产品推荐
相关产品推荐

