ASP.NET Core 8 运行时动态生成API端点方案咨询

针对你的业务场景（基于数据库中EntityType和Field表动态生成对应API端点），结合你已掌握的动态类型生成与数据填充能力，以下是两种可行的实现方案：

一、基于Minimal API的动态端点注册 #

思路 #

利用Minimal API的委托式注册特性，读取数据库中的实体定义后，为每个EntityType生成对应GET端点，内部复用你已有的数据填充逻辑返回强类型集合。

实现代码 #

// 端点注册逻辑（可放在Program.cs或独立初始化类中）
public static void RegisterDynamicMinimalEndpoints(WebApplication app, YourDbContext dbContext)
{
    var entityTypes = dbContext.EntityTypes.Include(e => e.Fields).ToList();
    foreach (var entityType in entityTypes)
    {
        // 调用你已有的动态类型生成方法，创建对应实体类型
        Type dynamicEntity = YourDynamicTypeGenerator.CreateType(
            entityType.Name, 
            entityType.Fields.Select(f => f.Name));

        // 构造路由（如Car对应/cars）
        string route = $"/{entityType.Name.ToLowerInvariant()}";

        // 反射构建通用查询方法的委托
        var getMethod = typeof(DynamicEndpointHandlers)
            .GetMethod(nameof(DynamicEndpointHandlers.GetEntities))
            .MakeGenericMethod(dynamicEntity);

        var requestDelegate = (RequestDelegate)Delegate.CreateDelegate(
            typeof(RequestDelegate),
            getMethod.CreateDelegate(typeof(Func<HttpContext, YourDbContext, Task>)));

        // 注册端点并配置元数据
        app.MapGet(route, requestDelegate)
           .WithName($"Get{entityType.Name}Collection")
           .Produces<IEnumerable<dynamic>>(StatusCodes.Status200OK);
    }
}

// 通用端点处理类
public static class DynamicEndpointHandlers
{
    public static async Task GetEntities<T>(HttpContext context, YourDbContext dbContext)
    {
        // 调用你已有的数据填充逻辑，获取强类型数据集合
        IEnumerable<T> data = await YourDataFiller.Fill<T>(dbContext, typeof(T).Name);
        await context.Response.WriteAsJsonAsync(data);
    }
}

优缺点 #

• ✅ 轻量简洁，无需复杂的控制器生命周期管理
• ✅ 快速实现基础CRUD端点
• ❌ 对MVC特性（如过滤器、模型验证）的支持需要额外手动配置

二、动态生成MVC控制器并注册 #

思路 #

通过反射Emit生成继承自ControllerBase的动态控制器类，包含对应Action方法，再将生成的程序集注册到ASP.NET Core的控制器发现系统中，完全复用MVC框架的特性。

实现代码 #

// 动态生成控制器程序集
public static Assembly BuildDynamicControllersAssembly(IEnumerable<EntityType> entityTypes)
{
    var assemblyName = new AssemblyName("DynamicMvcControllers");
    var assemblyBuilder = AssemblyBuilder.DefineDynamicAssembly(assemblyName, AssemblyBuilderAccess.Run);
    var moduleBuilder = assemblyBuilder.DefineDynamicModule("DynamicControllersModule");

    foreach (var entityType in entityTypes)
    {
        Type dynamicEntity = YourDynamicTypeGenerator.CreateType(
            entityType.Name, 
            entityType.Fields.Select(f => f.Name));

        // 定义控制器类（如CarController）
        TypeBuilder controllerBuilder = moduleBuilder.DefineType(
            $"{entityType.Name}Controller",
            TypeAttributes.Public | TypeAttributes.Class,
            typeof(ControllerBase));

        // 添加Route特性，匹配api/[controller]模板
        var routeAttrCtor = typeof(RouteAttribute).GetConstructor(new[] { typeof(string) });
        var routeAttr = new CustomAttributeBuilder(routeAttrCtor, new object[] { "api/[controller]" });
        controllerBuilder.SetCustomAttribute(routeAttr);

        // 定义Get Action方法
        MethodBuilder getActionBuilder = controllerBuilder.DefineMethod(
            "Get",
            MethodAttributes.Public | MethodAttributes.Virtual,
            typeof(IEnumerable<>).MakeGenericType(dynamicEntity),
            Type.EmptyTypes);

        ILGenerator il = getActionBuilder.GetILGenerator();
        // IL指令：获取DbContext实例，调用数据填充方法
        il.Emit(OpCodes.Ldarg_0);
        il.Emit(OpCodes.Call, typeof(ControllerBase).GetProperty(nameof(ControllerBase.HttpContext))!.GetMethod!);
        il.Emit(OpCodes.Call, typeof(HttpContext).GetProperty(nameof(HttpContext.RequestServices))!.GetMethod!);
        il.Emit(OpCodes.Call, typeof(ServiceProviderServiceExtensions).GetMethod(nameof(ServiceProviderServiceExtensions.GetService))!.MakeGenericMethod(typeof(YourDbContext)));
        il.Emit(OpCodes.Ldstr, entityType.Name);
        il.Emit(OpCodes.Call, typeof(YourDataFiller).GetMethod(nameof(YourDataFiller.Fill))!.MakeGenericMethod(dynamicEntity));
        il.Emit(OpCodes.Ret);

        // 完成控制器类型创建
        controllerBuilder.CreateType();
    }

    return assemblyBuilder;
}

// 在Program.cs中注册动态控制器
var dynamicAssembly = BuildDynamicControllersAssembly(dbContext.EntityTypes.Include(e => e.Fields).ToList());
builder.Services.AddControllers()
    .AddApplicationPart(dynamicAssembly)
    .AddControllersAsServices();

优缺点 #

• ✅ 完全支持MVC的所有特性（过滤器、模型验证、路由约束等）
• ✅ 符合传统API开发模式，便于扩展复杂逻辑
• ❌ 实现复杂度较高，需要熟悉反射Emit的使用

运行时端点更新机制 #

由于你的场景需要随时新增EntityType，需实现动态更新逻辑：

• 定时轮询数据库，检测新增的实体定义，触发端点注册逻辑
• 在新增EntityType的业务接口中，添加端点注册的触发事件
• 对于Minimal API：可通过app.MapGroup("")动态添加子端点；对于MVC控制器：需自定义IControllerFeatureProvider支持动态刷新控制器集合

关键注意事项 #

1. 缓存优化：缓存已生成的动态类型和端点，避免重复生成带来的性能开销
2. 序列化配置：确保动态生成的类型能被System.Text.Json正确序列化（可在生成类型时添加JsonPropertyName特性）
3. 异常处理：为动态端点添加全局异常捕获，避免数据填充错误导致API崩溃
4. 版本控制：若需API版本支持，可在注册端点时添加版本路由约束

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