.NET 7中Swagger/OpenAPI 3.0是否必须添加[HttpGet]属性？

问题现象 #

• 学习.NET 5教程时，讲师定义的未加[HttpGet]属性的端点能正常运行，但自己的.NET 7项目里，以下两个端点在Swagger UI中报错：Actions require an explicit HttpMethod binding for Swagger/OpenAPI 3.0
• 涉及的代码片段：

[Route("{id:int}")]
[ProducesResponseType(StatusCodes.Status200OK)]
[ProducesResponseType(StatusCodes.Status404NotFound)]
public ActionResult<Dto> DoSomething()
{
    // 方法实现
}

[Route("{name}")]
[ProducesResponseType(StatusCodes.Status200OK)]
[ProducesResponseType(StatusCodes.Status404NotFound)]
public ActionResult<DTO> DoSomething2()
{
    // 方法实现
}

• 添加[HttpGet]属性后，Swagger恢复正常，且直接在浏览器中调用这些REST接口也能正常工作

问题解答 #

不是Swagger/OpenAPI 3.0本身强制要求必须加[HttpGet]，而是.NET 7的路由规则和Swagger的文档生成逻辑有了变化：

1. 早期.NET版本的行为：在.NET 5及更早版本中，控制器方法如果命名以Get/Post等前缀开头，框架会自动推断对应的Http请求方法，不需要显式标记属性
2. .NET 6+的变化：从.NET 6开始，框架默认启用了更严格的路由绑定规则，同时Swagger对OpenAPI 3.0规范的实现更严谨——它需要明确的Http方法元数据来生成正确的接口文档，无法再依赖方法名推断
3. 浏览器调用正常的原因：浏览器发起的请求默认是GET方法，框架能通过路由匹配到对应的方法，但Swagger需要明确知道该接口支持的请求方法类型，才能生成符合规范的文档，所以必须显式添加[HttpGet]（或[HttpPost]等）属性

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