ASP.NET Core自定义多Action名称属性无效原因咨询

我想给ASP.NET Core里同一个Action设置多个名称，于是自定义了支持多名称的MultipleActionNamesAttribute，但这个属性完全不生效，这是为什么？

相关代码 #

官方标准ActionNameAttribute #

[AttributeUsage(AttributeTargets.Method, AllowMultiple = false, Inherited = true)]
public sealed class ActionNameAttribute : Attribute
{
    public ActionNameAttribute(string name)
    {
        Name = name;
    }
    public string Name { get; }
}

自定义的MultipleActionNamesAttribute #

[AttributeUsage(AttributeTargets.Method, AllowMultiple = true)]
public class MultipleActionNamesAttribute(string name) : Attribute
{
    public string Name { get; set; } = name;
}

控制器中的Action代码 #

//[ActionName("Test1")] // 生效
[MultipleActionNames("Test1")] // 不生效
[MultipleActionNames("Test2")] // 不生效
public IActionResult TestPage()
{
    return View("TestPage");
}

原因分析 #

ASP.NET Core的路由系统只默认识别官方的ActionNameAttribute，它的内部逻辑专门针对这个属性做了处理——在匹配Action时，会读取该属性的值作为Action的别名。而你自定义的MultipleActionNamesAttribute只是一个普通特性，框架根本不知道它的用途，自然不会去解析它。

另外，你的自定义属性仅继承了Attribute基类，没有实现任何路由系统需要的接口或注入相关逻辑，所以完全不会被路由匹配流程所感知。

解决办法 #

方案一：自定义路由约定（推荐） #

通过实现IActionModelConvention接口，让框架识别你的自定义属性，并为Action添加多个访问名称：

public class MultipleActionNamesConvention : IActionModelConvention
{
    public void Apply(ActionModel action)
    {
        // 获取Action上的所有自定义多名称属性
        var attributes = action.MethodInfo.GetCustomAttributes<MultipleActionNamesAttribute>(true);
        foreach (var attr in attributes)
        {
            // 给当前Action添加一个新的路由选择器，对应自定义的名称
            action.Selectors.Add(new SelectorModel
            {
                AttributeRouteModel = new AttributeRouteModel
                {
                    Template = $"[controller]/{attr.Name}"
                }
            });
        }
    }
}

然后在Program.cs中注册这个约定：

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

这样配置后，TestPage Action就能通过Test1、Test2以及原名称TestPage三个路径访问了。

方案二：直接使用多Route属性（简单场景） #

如果需求不复杂，直接给Action添加多个[Route]属性即可快速实现多名称访问：

[Route("Test1")]
[Route("Test2")]
[Route("TestPage")] // 保留原Action名称的访问路径
public IActionResult TestPage()
{
    return View("TestPage");
}

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