仅一个GET方法的ASP.NET Web API 2控制器触发Swagger冲突报错

嘿，我一眼就瞅出问题所在了！你的DemoController继承的是ControllerBase，但这可是ASP.NET Core Web API的控制器基类啊，而你的项目明显是ASP.NET Web API 2（从命名空间和返回类型IHttpActionResult就能看出来）——Web API 2的控制器得继承ApiController才对！

这就是Swagger报错的核心原因：当你在Web API 2项目里错用了ASP.NET Core的ControllerBase当基类时，Swashbuckle（Web API 2的Swagger工具）在扫描控制器的时候，会把基类自带的一堆默认HTTP方法（比如各种重载的Get、Post方法）都算进来，这些方法和你自己写的GetProducts方法路径都是api/Demo、HTTP方法都是GET，Swagger自然就认为有冲突了，于是抛出那个“Multiple operations”的错误。

另外还有个小细节：你的方法是异步的async Task<IHttpActionResult>，虽然Web API 2支持异步，但搭配错误的基类会让这个问题更突出。

具体解决步骤 #

1. 修正控制器基类：把ControllerBase换成ApiController，别忘了确保引用的是System.Web.Http命名空间下的ApiController：

   namespace WMWebAPIControllers.Controllers {
    [RoutePrefix("api/Demo")]
    public class DemoController : ApiController { // 这里改成ApiController
     [HttpGet]
     [Route("")]
     public async Task<IHttpActionResult> GetProducts(int CatalogType, string ProductNo) {
      return Ok();
     }
    }
   }
   

2. 清理并重新生成项目：有时候Visual Studio会缓存旧的类型信息，先清理解决方案，再重新生成，确保Swagger能正确识别修改后的控制器。

3. （可选）临时权宜之计：如果改完基类还没解决，或者你暂时没法改基类，可以在Swagger配置里设置ResolveConflictingActions来强制合并冲突操作，但这只是临时 workaround，根本解决还是要修正基类：

   GlobalConfiguration.Configuration
       .EnableSwagger(c =>
       {
           // 遇到冲突时取第一个识别到的操作
           c.ResolveConflictingActions(apiDescriptions => apiDescriptions.First());
           // 其他Swagger配置...
       })
       .EnableSwaggerUi();
   

额外提醒 #

虽然Swagger的错误提示看起来像是你写了多个同路径同方法的接口，但实际上是错误的基类导致Swagger误判了。只要把基类换回Web API 2专属的ApiController，这个问题应该就能彻底解决啦。

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