WebApi同路由配置下控制器调用DeleteAsync未命中问题

问题场景 #

项目基于WebApi2开发，采用特性路由配置，同一控制器下的Get和Delete接口共用api/Products/{id}路由模板，接收相同的整型id路由参数。从MVC控制器发起WebApi调用时，代码追踪到DeleteAsync执行环节，始终无法触发WebApi端的Delete方法。

相关参考代码 #

WebApi端代码

[Route("api/Products/{id}")]
public IHttpActionResult Get(int id)
{
    List<ProductModel> showProductById = dbOperations.ShowProductById(id);
    return Ok(showProductById);
}

[Route("api/Products/{id}")]
public IHttpActionResult Delete(int id)
{
    int rowId = dbOperations.DeleteProduct(id);
    return Ok(rowId);
}

MVC控制器调用端代码

public ActionResult DeleteProduct(int id)
{
    productApiClient.BaseAddress = new Uri(ConfigurationManager.AppSettings["BaseAddress"]);
    var response = productApiClient.DeleteAsync("Products/" + id).Result;
    return RedirectToAction("Index");
}

核心排查点与修复方案 #

• 缺少HTTP方法谓词的特性标记（最高发原因）
  WebApi的特性路由匹配采用「路由模板+HTTP请求方法」双维度校验逻辑：仅配置路由模板时，系统只能识别路径匹配关系，无法将不同HTTP方法的请求精准路由到对应方法。
  需要明确：方法名自动匹配HTTP谓词的规则（比如方法名以Get开头就默认对应GET请求），仅在约定式路由场景下生效；一旦启用特性路由，这套自动识别逻辑就会失效。当前代码里的Get方法能被正常触发，是碰巧匹配到了遗留的默认识别规则，但Delete方法没有显式标记[HttpDelete]特性，系统根本不会将DELETE类型的请求绑定到这个方法上。
  修复方式：为Delete方法补充显式的HTTP谓词特性标记。

  [HttpDelete]
  [Route("api/Products/{id}")]
  public IHttpActionResult Delete(int id)
  {
      int rowId = dbOperations.DeleteProduct(id);
      return Ok(rowId);
  }
  

• 请求路径拼接不匹配
  检查调用端DeleteAsync传入的相对路径：当前代码传入的路径是"Products/" + id，但WebApi端配置的路由模板是api/Products/{id}。如果配置的BaseAddress没有以api/路径段结尾，最终实际发出的请求路径会是{BaseAddress}/Products/{id}，和WebApi端的路由模板完全不匹配，自然无法命中接口。
  修复方式：保证拼接后的完整请求路径和WebApi端的路由模板完全一致，可以在调用时补全路径前缀，也可以在配置BaseAddress时就带上api/路径段。

  // 补全路径前缀示例
  var response = productApiClient.DeleteAsync("api/Products/" + id).Result;
  

• IIS管道对DELETE请求的拦截
  部分IIS站点默认配置下，静态文件处理模块的优先级高于WebApi路由管道，会直接拦截DELETE、PUT这类非GET/POST的请求，返回405方法不允许的错误，根本不会将请求转发到WebApi的处理逻辑。
  修复方式：在项目的Web.config中调整处理器配置，将所有动词的请求都转发到WebApi的处理管道，避免被静态文件模块拦截。

  <system.webServer>
    <handlers>
      <remove name="ExtensionlessUrlHandler-Integrated-4.0" />
      <remove name="OPTIONSVerbHandler" />
      <remove name="TRACEVerbHandler" />
      <add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" 
           type="System.Web.Handlers.TransferRequestHandler" 
           preCondition="integratedMode,runtimeVersionv4.0" />
    </handlers>
  </system.webServer>
  

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