ASP.NET Core 9 跨程序集继承时，为什么只使用子控制器的路由？

2026-11-04数据小陈

结论

在 ASP.NET Core 9 的默认 MVC 行为下，如果子控制器声明了路由，MVC 会使用子类这一层的控制器路由，不会自动合并父类路由。父类位于另一个程序集，不会改变这一规则。

要让同一个控制器提供两个入口，可以在子控制器上显式声明两个 [Route]。

为什么 Inherited 和 AllowMultiple 没有让两条路由同时生效？

这两个设置描述的是特性的使用和继承规则：

AllowMultiple = true：允许在同一个类或方法上声明多个 RouteAttribute。
Inherited = true：允许派生类型通过支持继承的特性查询获取基类特性。

MVC 构建控制器模型时还会筛选路由特性。ASP.NET Core 9 的 DefaultApplicationModelProvider.CreateControllerModel 从当前控制器向基类查找，找到第一层直接声明了 IRouteTemplateProvider 特性的类型后，就采用该层的路由特性，不再合并更上层的路由。参见 ASP.NET Core 9 源码。

因此，特性可以被继承，但 MVC 不一定会把父子类的路由全部注册。

如何让子控制器同时提供两条路由？

在子控制器上显式列出两个路由模板。下面使用示例路径，实际使用时请替换为项目中的路径。

类库中的父控制器：

using Microsoft.AspNetCore.Mvc;

[Route("api/base")]
public abstract class BaseApiController : ControllerBase
{
}

API 项目中的子控制器：

using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/base")]
[Route("api/child")]
public class ChildController : BaseApiController
{
    [HttpGet("status")]
    public IActionResult GetStatus()
    {
        return Ok(new { status = "ok" });
    }
}

在正常注册控制器路由的前提下，这个示例会为该 Action 提供两个入口：

GET /api/base/status
GET /api/child/status

这两个入口来自子类显式声明的两个 [Route]。ASP.NET Core 支持将控制器上的多个路由分别与 Action 的相对路由模板组合。参见多个特性路由的官方说明。

如果只需要沿用父类路由，移除子类上的控制器级路由声明，让 MVC 向上查找父类即可。

版本和 Swagger 还需要检查什么？

题目提到父类引用 Microsoft.AspNetCore.Mvc.Core Version=2.3.9.0，但没有提供项目文件或运行时加载信息，因此无法判断是否还存在依赖兼容性问题。上面的解释依据 ASP.NET Core 9 的默认实现；如果实际行为不同，需要进一步确认运行时加载的 MVC 程序集，以及是否存在自定义路由约定。

修改后，先分别请求两个实际 URL，再检查 Swagger 文档。如果两个入口都能访问，但文档缺少其中一条路径，请检查 API Explorer 的可见性、文档分组和过滤配置。如果实际入口也不存在，则需要继续检查控制器和 Action 的路由配置。