Web API控制器Route特性中[controller]的工作原理及疑问

先看你给出的代码示例：

[ApiController]
[Route("api/[controller]")]
public class HotelsController : ControllerBase
{
}

核心结论 #

[controller]是ASP.NET Core路由系统预定义的特定令牌，不是通用的“截取方括号内内容”的语法，你没法用自定义的[class]这类标记实现同样效果。

具体实现逻辑 #

路由系统处理[controller]的流程是固定的：

1. 框架识别路由模板中的[controller]这个特定标识；
2. 通过反射获取控制器类名，自动移除约定的Controller后缀（比如HotelsController会去掉Controller，得到Hotels）；
3. 默认将字符串转为小写（可通过路由配置修改大小写规则），替换进路由模板，最终生成api/hotels这样的URL。

为什么[class]行不通？ #

路由系统只内置了几个特定的路由令牌，比如[controller]、[action]、[area]，根本没有[class]这个预定义标记。它不会去解析方括号内的任意字符串，再去匹配类名的对应部分——整个替换逻辑是硬编码针对[controller]设计的，不是通用匹配机制。

如果你想自定义类似的替换逻辑，需要自己扩展路由系统的令牌解析逻辑，但这属于框架级的定制，一般业务开发没必要这么做。

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