ASP.NET Core多Controller同名Create方法致API定义冲突求助

你遇到的是路由歧义错误——两个控制器的Create方法（均为POST请求）的路由模板完全一致，ASP.NET Core无法判断应该将请求转发给哪个Action。

解决方法 #

1. 给控制器设置唯一的路由前缀 #

这是最直接的方案，确保每个控制器的路由前缀不重复：

// CategoryController.cs
[ApiController]
[Route("api/categories")] // 唯一路由前缀
public class CategoryController : ControllerBase
{
    [HttpPost]
    public IActionResult Create([FromBody] CategoryCreateDto model)
    {
        // 业务逻辑
        return Ok();
    }
}

// CustomerController.cs
[ApiController]
[Route("api/customers")] // 唯一路由前缀
public class CustomerController : ControllerBase
{
    [HttpPost]
    public IActionResult Create([FromBody] CustomerCreateDto model)
    {
        // 业务逻辑
        return Ok();
    }
}

此时两个Create方法的路由分别为POST api/categories和POST api/customers，完全区分开。

2. 给Action指定专属路由片段 #

如果控制器需要共用前缀，可以给每个Create方法添加不同的路由片段：

// CategoryController.cs
[ApiController]
[Route("api/entities")]
public class CategoryController : ControllerBase
{
    [HttpPost("category")] // 专属路由片段
    public IActionResult Create([FromBody] CategoryCreateDto model)
    {
        return Ok();
    }
}

// CustomerController.cs
[ApiController]
[Route("api/entities")]
public class CustomerController : ControllerBase
{
    [HttpPost("customer")] // 专属路由片段
    public IActionResult Create([FromBody] CustomerCreateDto model)
    {
        return Ok();
    }
}

对应路由为POST api/entities/category和POST api/entities/customer。

3. 在路由中包含Action名称 #

修改控制器的路由模板，加入[action]令牌，让Action名称成为路由的一部分：

// CategoryController.cs
[ApiController]
[Route("api/[controller]/[action]")]
public class CategoryController : ControllerBase
{
    [HttpPost]
    public IActionResult Create([FromBody] CategoryCreateDto model)
    {
        return Ok();
    }
}

// CustomerController.cs
[ApiController]
[Route("api/[controller]/[action]")]
public class CustomerController : ControllerBase
{
    [HttpPost]
    public IActionResult Create([FromBody] CustomerCreateDto model)
    {
        return Ok();
    }
}

此时路由为POST api/Category/Create和POST api/Customer/Create，自然不会冲突。

4. 检查全局路由配置 #

如果你的Program.cs中使用了约定路由（比如MapControllerRoute），确保模板不会导致歧义。推荐使用属性路由（配合MapControllers()），更灵活且不易冲突：

// Program.cs
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();

var app = builder.Build();

app.UseHttpsRedirection();
app.UseAuthorization();

app.MapControllers(); // 启用属性路由，匹配控制器上的[Route]特性

app.Run();

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