ASP.NET Core Web API：能否在Startup中注册外部控制器？

完全可以实现这种需求——ASP.NET Core支持从外部程序集加载控制器，无需在当前项目中创建对应的控制器类。你可以通过封装扩展方法的方式，将外部控制器的注册逻辑统一封装，让调用更简洁。

核心原理 #

默认情况下，ASP.NET Core仅扫描当前项目的程序集来发现控制器。要加载外部程序集中的控制器，需要将目标程序集添加到**应用部件（Application Part）**中，告诉框架去扫描该程序集下的控制器类型。

具体实现步骤 #

1. 外部程序集的控制器示例

假设外部程序集中已存在处理POST /foo请求的控制器：

using Microsoft.AspNetCore.Mvc;

namespace ExternalControllers;

public class FooController : ControllerBase
{
    [HttpPost("/foo")]
    public IActionResult ProcessFooRequest([FromBody] FooRequest request)
    {
        // 自定义处理逻辑
        return Ok(new { Status = "Success", Data = request });
    }
}

public class FooRequest
{
    public string Content { get; set; }
}

2. 封装扩展方法

在当前项目中创建静态扩展类，封装外部控制器的注册逻辑：

using Microsoft.AspNetCore.Mvc.ApplicationParts;
using Microsoft.Extensions.DependencyInjection;
using ExternalControllers; // 引用外部控制器的命名空间

public static class FooControllerExtensions
{
    // 推荐在ConfigureServices阶段注册，符合ASP.NET Core的服务注册习惯
    public static IServiceCollection AddFooController(this IServiceCollection services)
    {
        // 获取外部控制器所在的程序集
        var fooAssembly = typeof(FooController).Assembly;
        
        // 将该程序集添加到控制器应用部件，并配置控制器作为服务（支持依赖注入）
        services.AddControllers()
                .AddApplicationPart(fooAssembly)
                .AddControllersAsServices();
        
        return services;
    }

    // 若需要在Configure阶段调用，可封装空实现或补充额外逻辑
    public static IApplicationBuilder UseFooController(this IApplicationBuilder app)
    {
        // 核心注册逻辑已在AddFooController中完成，此处可添加路由验证等额外操作
        return app;
    }
}

3. 在项目中调用扩展方法

根据你的.NET版本，在启动类中调用扩展方法：

.NET 5及更早版本（Startup.cs）

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // 注册外部Foo控制器
        services.AddFooController();
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        app.UseRouting();
        app.UseAuthorization();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllers(); // 映射所有控制器路由，包括外部的
        });

        // 可选调用，若扩展方法中有额外逻辑则执行
        app.UseFooController();
    }
}

.NET 6+版本（Program.cs）

var builder = WebApplication.CreateBuilder(args);

// 注册外部Foo控制器
builder.Services.AddFooController();

var app = builder.Build();

app.UseRouting();
app.UseAuthorization();

app.MapControllers();

app.Run();

注意事项 #

• 确保外部程序集已被当前项目引用（可通过项目引用、NuGet包或直接添加DLL引用实现）
• 如果外部控制器存在构造函数依赖，需确保这些依赖已在当前项目的服务容器中注册
• AddControllersAsServices()是可选配置，若控制器需要依赖注入，建议添加该方法，让框架以服务方式解析控制器

内容的提问来源于stack exchange，提问作者Piotr Zdun