You need to enable JavaScript to run this app. .NET 5 动态加载DLL及依赖时EF缺失、接口未实现报错如何解决
优惠活动
大模型
产品
解决方案
定价
更多

.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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 00:36:06