C# API控制器与ControllerBase区别及HTTP Attributes使用疑问

1. API Controller与ControllerBase的区别 #

二者的核心差异在于定位和内置功能：

• ControllerBase 是ASP.NET Core所有控制器的底层基类，仅包含Web API所需的核心能力，比如路由绑定、响应生成、模型验证、状态码返回等，完全不含MVC视图相关逻辑，专门用于构建无视图的RESTful API服务。
• 通常所说的「API Controller」，指的是继承了ControllerBase且标注了[ApiController]特性的控制器，它在ControllerBase基础上额外封装了API开发专属的默认行为：
  • 自动触发模型验证失败的400响应，无需手动判断ModelState.IsValid
  • 自动推断请求参数的绑定源，无需额外加[FromBody]/[FromQuery]等绑定特性
  • 强制要求配置路由特性，不支持传统MVC的基于控制器名的默认路由
  • 对API常见错误场景做了统一响应格式优化

补充说明：还有一个Controller类同样继承自ControllerBase，额外封装了视图、ViewBag、TempData等网页开发相关能力，仅做API开发时不需要使用该类。

2. HTTP特性（HTTP Attributes）的使用规则 #

什么时候需要使用HTTP特性 #

只要你需要明确指定某个Action对应的请求方法，或者需要自定义该Action的路由规则时，都建议显式添加[HttpGet]/[HttpPost]/[HttpPut]等HTTP特性，这是工业界公认的规范写法，可读性和可维护性最高。

未加HTTP特性的控制器如何区分请求方法 #

ASP.NET Core内置了默认的请求方法匹配规则，没有显式加HTTP特性时，框架会根据Action的名称前缀自动推断：

• Action名以Get开头（如GetUserInfo、GetAllOrder），默认匹配GET请求
• Action名以Post开头，默认匹配POST请求
• 同理Put前缀匹配PUT、Delete前缀匹配DELETE、Patch前缀匹配PATCH
• 如果Action名没有对应方法前缀，框架会默认允许所有HTTP请求方法访问，只要路由匹配就可以进入Action逻辑。

不使用HTTP特性的原因 #

绝大多数场景下都不建议省略HTTP特性，少数省略的情况通常为：

• 内部测试用的简易接口，不需要严格限制请求方法
• 少数通用处理Action，设计上确实需要支持多种请求方法访问
• 从旧版ASP.NET MVC迁移的老项目，保留了历史写法没有做规范统一

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