.NET 6 MVC同路由多Http方法映射失败（405错误）

针对你遇到的405错误和路由冲突问题，以下是可落地的解决步骤：

1. 用属性路由明确绑定HTTP方法与路由 #

在控制器上统一设置基础路由，然后为每个方法添加对应的HTTP特性标记，确保路由模板一致但HTTP方法不同，这是.NET MVC中处理RESTful路由的标准方式：

[Route("api/[controller]")]
[ApiController] // 必须添加，自动处理路由匹配、模型验证等逻辑
public class YourController : ControllerBase
{
    // POST api/your/123
    [HttpPost("{id:int}")] // int约束确保参数类型匹配，避免歧义
    public IActionResult Post(int id, [FromBody] YourModel model)
    {
        // 业务逻辑
        return Ok();
    }

    // PUT api/your/123
    [HttpPut("{id:int}")]
    public IActionResult Put(int id, [FromBody] YourModel model)
    {
        // 业务逻辑
        return Ok();
    }

    // DELETE api/your/123
    [HttpDelete("{id:int}")]
    public IActionResult Delete(int id)
    {
        // 业务逻辑
        return NoContent();
    }
}

这种方式下，相同路由URL会根据HTTP方法自动映射到对应控制器方法，不会出现冲突。

2. 排查405错误的常见诱因 #

• WebDAV模块拦截：如果部署在IIS环境，WebDAV默认会拦截PUT/DELETE请求，需禁用。可以在Program.cs中添加：

  builder.Services.Configure<IISServerOptions>(options =>
  {
      options.FeatureProviders.RemoveAll(p => p.GetType().Name == "WebDavFeatureProvider");
  });
  

  或者在项目的web.config中配置：

  <system.webServer>
    <modules>
      <remove name="WebDAVModule" />
    </modules>
  </system.webServer>
  

• CORS配置缺失：如果cURL请求是跨域的，需确保CORS策略允许对应的HTTP方法：

  builder.Services.AddCors(options =>
  {
      options.AddPolicy("AllowAll", policy =>
      {
          policy.AllowAnyOrigin()
                .AllowAnyHeader()
                .AllowAnyMethod(); // 或指定允许的方法：WithMethods("POST", "PUT", "DELETE")
      });
  });
  
  // 在中间件中启用CORS（要放在UseRouting之后，UseEndpoints之前）
  app.UseCors("AllowAll");
  

3. 避免路由冲突的额外注意事项 #

• 不要为相同HTTP方法定义相同路由模板的方法，比如两个[HttpPut("{id}")]会触发冲突，但不同HTTP方法无此问题。
• 若使用传统路由而非属性路由，需在路由约束中指定允许的HTTP方法：

  app.UseEndpoints(endpoints =>
  {
      endpoints.MapControllerRoute(
          name: "api",
          pattern: "api/{controller}/{id?}",
          constraints: new { httpMethod = new HttpMethodConstraint("POST", "PUT", "DELETE") });
  });
  

  但属性路由更直观，推荐优先使用。

4. 验证Swagger配置正确性 #

确保Swagger能正确识别所有HTTP方法，Program.cs中的配置示例：

builder.Services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "你的API名称", Version = "v1" });
});

// 中间件配置（放在UseRouting之后）
app.UseSwagger();
app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "你的API V1");
});

配置完成后可通过Swagger UI直接测试PUT/DELETE请求，确认路由映射正常。

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