ASP.NET Core如何加载外部DLL配置路由将其方法作为WebAPI调用

优先在插件DLL内部按照标准ASP.NET Core WebAPI的写法定义路由特性，不需要主应用手动为方法分配路由。你现在遇到的核心问题不是路由定义位置的问题，是你只把插件DLL加载到了当前应用域，但没有把程序集告知MVC框架的部件扫描机制，框架根本识别不到DLL内部的控制器，自然不会把对应方法映射为可调用的API接口。

具体实现步骤 #

1. 插件DLL端的写法 #

插件DLL不需要独立实现ASP.NET Core启动逻辑，只需要引用Microsoft.AspNetCore.Mvc.Core包即可，内部API控制器的写法和主应用内置的控制器完全一致：

• 控制器类必须标记为public，不能用默认的internal访问修饰符，否则框架反射扫描不到
• 正常使用[ApiController]、[Route]、[HttpGet]/[HttpPost]等标准特性定义路由和请求方法

示例代码：

[ApiController]
[Route("api/plugin/[controller]")]
public class UserPluginController : ControllerBase
{
    // 对应路由 GET api/plugin/userplugin/list
    [HttpGet("list")]
    public IActionResult GetUserList()
    {
        return Ok(new { Data = "来自插件DLL的用户列表数据" });
    }
}

2. 主应用端的注册逻辑 #

你之前写的Assembly.LoadFrom仅完成了程序集的加载，还需要在注册MVC服务时，把加载到的插件程序集作为应用部件加入MVC的扫描列表，这是让框架识别插件控制器的核心步骤。

以.NET 6+ 顶级语句写法为例：

// 你已实现的插件加载逻辑
string dllFullPath = Path.Combine(AppContext.BaseDirectory, "plugins", "MyPlugin.dll");
Assembly assemblyPlugin = Assembly.LoadFrom(dllFullPath);

var builder = WebApplication.CreateBuilder(args);

// 注册控制器服务时追加插件部件
builder.Services.AddControllers()
    .AddApplicationPart(assemblyPlugin) // 核心配置：让MVC扫描插件程序集内的控制器
    .AddControllersAsServices(); // 可选配置：将插件内的控制器注册到DI容器，支持构造函数注入主应用的服务

如果有多个插件DLL，循环加载每个DLL后重复调用AddApplicationPart传入对应程序集即可。

为什么不推荐主应用手动分配路由 #

手动分配路由的方案完全没有必要，存在明显缺陷：

• 需要自行实现反射遍历类型方法、路由匹配、参数绑定、请求响应处理等逻辑，相当于重写了一遍MVC框架的核心路由功能，重复造轮子
• 插件和主应用强耦合，每次插件调整接口路由、新增接口都需要修改主应用的路由适配逻辑，完全失去插件化独立迭代的灵活性

常见注意事项 #

• 插件DLL引用的Microsoft.AspNetCore.*相关包版本要和主应用版本保持一致，避免出现程序集加载冲突；建议插件项目将框架级引用设置为“不复制本地”，由主应用统一提供运行时依赖
• 如果插件需要注册自定义服务到DI容器，可以在插件内定义统一的注册入口（比如约定一个IPluginInstall接口，实现类中编写服务注册逻辑），主应用加载程序集后反射找到实现类，调用注册方法即可
• 如果需要支持插件热更新/动态卸载，建议使用自定义AssemblyLoadContext做程序集隔离，避免DLL被进程占用无法替换

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