ASP.NET Core获取端点参数绑定元数据的通用方法

这类参数映射信息确实存储在端点元数据中，框架已经提供了统一的获取入口，不需要自行编写反射解析委托参数的样板代码，EndpointsApiExplorer和Swagger底层也依赖这套通用元数据。

核心实现原理 #

不管是控制器类型的端点，还是最小API直接映射的端点，应用启动构建端点时，框架会自动解析所有参数的绑定规则（包括[FromQuery]指定的别名、绑定源等信息），统一封装为EndpointParameterMetadata类型的元数据条目，挂载到对应Endpoint对象的Metadata集合中。

这套元数据对两类端点完全通用，不需要分开处理ControllerActionDescriptor和最小API委托的差异。

具体实现步骤 #

• 在请求管道中，路由匹配完成后通过HttpContext.GetEndpoint()获取当前请求匹配的端点实例
• 从端点的Metadata集合中筛选所有EndpointParameterMetadata类型的条目
• 过滤出绑定源为BindingSource.Query的参数，直接读取其Name属性，即可得到该端点允许接收的所有查询字符串参数名——这个值已经是框架解析完成的最终绑定名，无论是特性指定的别名还是默认参数名都可以直接拿到，不需要自行读取绑定特性计算。

校验逻辑示例 #

// 注意：该中间件必须放在app.UseRouting()之后，端点执行中间件之前
app.Use(async (context, next) =>
{
    var currentEndpoint = context.GetEndpoint();
    if (currentEndpoint == null)
    {
        await next();
        return;
    }

    // 提取当前端点所有合法的查询参数名，忽略大小写匹配
    var allowedQueryKeys = currentEndpoint.Metadata
        .OfType<EndpointParameterMetadata>()
        .Where(paramMeta => paramMeta.BindingSource == BindingSource.Query)
        .Select(paramMeta => paramMeta.Name)
        .ToHashSet(StringComparer.OrdinalIgnoreCase);

    // 遍历请求携带的所有查询参数做校验
    foreach (var requestQueryKey in context.Request.Query.Keys)
    {
        if (!allowedQueryKeys.Contains(requestQueryKey))
        {
            context.Response.StatusCode = StatusCodes.Status400BadRequest;
            await context.Response.WriteAsync($"不支持的查询参数：{requestQueryKey}");
            return;
        }
    }

    await next();
});

注意事项 #

• 这套元数据在应用启动阶段就已经生成完成，运行时直接读取内存集合即可，没有反射开销
• 所有走框架默认绑定逻辑的查询参数（包括自定义绑定规则、全局约定生成的绑定参数）都会被包含在元数据中，不会遗漏
• 如果需要兼容复杂类型绑定到Query、自定义绑定源等特殊场景，可以搭配同元数据集合中的IBindingMetadataProvider相关条目做扩展，绝大多数场景下EndpointParameterMetadata已经能覆盖全部需求。

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