Minimal API通用CRUD动态端点映射：Add/Update接口实现难题

核心思路 #

放弃用dynamic作为参数类型，转而通过表达式树动态构建强类型请求处理委托，让Minimal API能识别实体类型，从而生成正确的Swagger Schema。

具体实现方案 #

方案一：泛型方法+反射批量注册 #

先写泛型方法处理单个实体的Add/Update端点，再通过反射遍历所有目标实体类型，调用泛型方法完成批量注册：

// 单个实体的Add端点注册逻辑（泛型）
private static void MapAddEndpoint<T>(WebApplication app) where T : class
{
    app.MapPost($"/api/{typeof(T).Name.ToLower()}", async (T entity, ICrudService<T> service) =>
    {
        await service.Add(entity);
        return Results.Created($"/api/{typeof(T).Name.ToLower()}/{{id}}", entity);
    })
    .WithName($"Add{typeof(T).Name}")
    .WithOpenApi();
}

// 批量注册所有实体的Add端点
public static void RegisterCrudEndpoints(this WebApplication app, IEnumerable<Type> entityTypes)
{
    var addEndpointMethod = typeof(YourRegistrationHelper).GetMethod(nameof(MapAddEndpoint), BindingFlags.NonPublic | BindingFlags.Static)!;
    
    foreach (var entityType in entityTypes)
    {
        var genericMethod = addEndpointMethod.MakeGenericMethod(entityType);
        genericMethod.Invoke(null, new object[] { app });
    }
}

方案二：表达式树直接构建强类型委托 #

如果需要更灵活的动态构建场景，用表达式树生成强类型的请求处理函数：

public static void MapDynamicAddEndpoint(this WebApplication app, Type entityType)
{
    // 定义委托的两个参数：实体实例、对应的ICrudService<T>
    var entityParam = Expression.Parameter(entityType, "entity");
    var serviceParam = Expression.Parameter(typeof(ICrudService<>).MakeGenericType(entityType), "service");

    // 构建调用service.Add(entity)的表达式
    var addMethod = typeof(ICrudService<>).MakeGenericType(entityType).GetMethod(nameof(ICrudService<object>.Add))!;
    var addCallExpr = Expression.Call(serviceParam, addMethod, entityParam);

    // 构建返回Results.Created的表达式
    var createdMethod = typeof(Results).GetMethod(nameof(Results.Created), new[] { typeof(string), typeof(object) })!;
    var routeExpr = Expression.Constant($"/api/{entityType.Name.ToLower()}/{{id}}");
    var createdCallExpr = Expression.Call(createdMethod, routeExpr, entityParam);

    // 组装异步lambda表达式
    var lambdaExpr = Expression.Lambda(
        Expression.Block(
            Expression.Await(addCallExpr),
            createdCallExpr
        ),
        entityParam,
        serviceParam
    );

    // 编译为强类型委托
    var delegateType = typeof(Func<,,>).MakeGenericType(entityType, typeof(ICrudService<>).MakeGenericType(entityType), typeof(Task<IResult>));
    var handler = lambdaExpr.CompileToDelegate(delegateType);

    // 映射Post端点
    app.MapPost($"/api/{entityType.Name.ToLower()}", handler)
        .WithName($"Add{entityType.Name}")
        .WithOpenApi();
}

关键注意事项 #

• 必须使用强类型参数而非dynamic，只有这样Minimal API的元数据系统才能识别参数类型，Swagger才能生成对应的请求Schema。
• 注册端点时务必调用.WithOpenApi()，确保Swagger能正确读取端点的元数据信息。
• 提前确保所有ICrudService<T>的泛型实现已注入DI容器，避免运行时依赖注入失败。

验证效果 #

完成注册后启动应用，Swagger将显示对应实体的Add接口，请求体自动生成该实体的完整Schema，效果与手动编写的强类型端点完全一致。

内容的提问来源于stack exchange，提问作者M. Ozn