EndpointMetadata是否包含继承特性？AspNet Core端点属性获取疑问

首先明确结论：EndpointMetadata/Metadata 集合默认不会自动包含从父类、基方法继承而来的特性，它仅包含直接应用在当前 Action、Controller 或路由端点上的特性，以及框架自动注入的元数据项。

针对继承特性的处理需求，有两种可行方案：

1. 手动预加载继承特性到元数据 #

可以通过自定义约定扩展，在应用启动时遍历 Controller 和 Action 的继承链，将父类/基方法的特性主动添加到 EndpointMetadata 集合中。示例代码如下：

public class InheritedAttributeConvention : IActionModelConvention
{
    public void Apply(ActionModel action)
    {
        // 收集方法和控制器继承链中的所有特性
        var inheritedAttributes = action.MethodInfo.GetCustomAttributes(true)
            .Concat(action.Controller.ControllerType.GetCustomAttributes(true))
            .OfType<Attribute>()
            .Where(attr => !action.EndpointMetadata.Contains(attr));
        
        foreach (var attr in inheritedAttributes)
        {
            action.EndpointMetadata.Add(attr);
        }
    }
}

随后在启动配置中注册该约定：

builder.Services.AddControllers(options =>
{
    options.Conventions.Add(new InheritedAttributeConvention());
});

2. 结合反射按需获取继承特性 #

如果不想修改元数据集合，也可以在检查特性时，先通过元数据快速判断直接应用的特性，无结果时再通过反射遍历继承链，兼顾性能与需求：

public static bool HasMyAttribute(ActionExecutingContext context)
{
    // 优先检查元数据（快速判断直接应用的特性）
    if (context.ActionDescriptor.EndpointMetadata.OfType<MyAttribute>().Any())
        return true;
    
    // 元数据无匹配时，通过反射检查继承特性
    if (context.ActionDescriptor is ControllerActionDescriptor actionDescriptor)
    {
        return actionDescriptor.MethodInfo.GetCustomAttributes(typeof(MyAttribute), true).Any()
            || actionDescriptor.ControllerTypeInfo.GetCustomAttributes(typeof(MyAttribute), true).Any();
    }
    
    return false;
}

关于微软的API说明 #

尽管微软标注 EndpointMetadata 为基础设施API，但实际项目中不少成熟组件（如权限验证、日志拦截类库）都在使用它。只要不依赖其内部实现细节，仅用于读取元数据，风险可控。

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