Web API中PUT与Delete动作的多路由配置失效问题

我之前也碰到过一模一样的问题，大概率是路由匹配顺序、约束设置或者方法规则不匹配导致的，咱们一步步来搞定：

首先得明确Web API的核心规则：路由是按注册顺序优先匹配的，如果默认路由（不带Action的）抢在带Action名称的路由前面注册，PUT/DELETE请求会先被默认路由拦截，而默认路由是靠HTTP动词+控制器名来匹配方法的，这时候带Action名称的请求自然就失效了。

第一步：调整路由注册顺序 #

必须把支持Action名称的路由放在默认路由前面，让带Action的请求先匹配到正确规则。

第二步：完善路由配置（添加约束+明确模板） #

给带Action的路由添加HTTP动词约束，确保它能处理PUT/DELETE请求，同时保留默认路由兼容原有调用模式。这里是完整的WebApiConfig配置代码：

public static class WebApiConfig
{
    public static void Register(HttpConfiguration config)
    {
        // 启用属性路由（如果项目里有用到的话）
        config.MapHttpAttributeRoutes();

        // 保留你原来的JSON媒体类型配置
        config.Formatters.JsonFormatter.SupportedMediaTypes.Add(new MediaTypeHeaderValue("application/octet-stream"));

        // 1. 优先注册带Action名称的路由，指定支持的HTTP动词
        config.Routes.MapHttpRoute(
            name: "DefaultApiWithAction",
            routeTemplate: "api/{controller}/{action}/{id}",
            defaults: new { id = RouteParameter.Optional },
            // 明确约束这个路由支持GET/POST/PUT/DELETE所有常用动词
            constraints: new { httpMethod = new HttpMethodConstraint(HttpMethod.Get, HttpMethod.Post, HttpMethod.Put, HttpMethod.Delete) }
        );

        // 2. 再注册默认路由（不带Action，靠HTTP动词匹配）
        config.Routes.MapHttpRoute(
            name: "DefaultApi",
            routeTemplate: "api/{controller}/{id}",
            defaults: new { id = RouteParameter.Optional }
        );
    }
}

第三步：确保Action方法的写法符合规则 #

不管是用带Action名称的调用模式，还是默认模式，你的PUT/DELETE方法都要满足匹配要求：

带Action名称的调用（比如 PUT api/Products/UpdateProduct/5）

需要给方法加上[HttpPut]/[HttpDelete]属性，明确绑定HTTP动词：

public class ProductsController : ApiController
{
    // PUT api/Products/UpdateProduct/5
    [HttpPut]
    public IHttpActionResult UpdateProduct(int id, Product product)
    {
        // 你的业务逻辑
        return Ok("更新成功");
    }

    // DELETE api/Products/DeleteProduct/5
    [HttpDelete]
    public IHttpActionResult DeleteProduct(int id)
    {
        // 你的业务逻辑
        return Ok("删除成功");
    }
}

默认模式调用（比如 PUT api/Products/5）

方法名可以以Put/Delete开头（自动匹配对应动词），或者用属性标记（方法名可自定义）：

// 方式1：方法名以Put开头，自动匹配PUT动词
public IHttpActionResult Put(int id, Product product)
{
    return Ok();
}

// 方式2：用[HttpPut]标记，方法名可任意命名
[HttpPut]
public IHttpActionResult UpdateProductInfo(int id, Product product)
{
    return Ok();
}

调试小技巧 #

如果还是有问题，可以用这两个方法排查：

• 用Postman/Fiddler测试：确认请求的URL、HTTP动词、请求体都完全符合配置规则；
• 查看路由注册情况：可以通过ApiExplorer输出所有已注册的路由，确认你的PUT/DELETE路由是否被正确加载。

内容的提问来源于stack exchange，提问作者Neeraj Kumar Gupta