为何触发AmbiguousMatchException？ASP.NET Core路由冲突咨询

你的问题核心是两个GET接口的路由模板完全冲突：虽然参数名分别是ieId和id，但ASP.NET Core路由系统匹配时只看模板的结构（即/api/projecttask/{int}），不关心参数的名称。因此当请求类似/api/projecttask/123的地址时，路由系统无法区分应该匹配哪个接口，导致AmbiguousMatchException。

解决方案：区分路由模板 #

最直接且清晰的解决方式是为两个接口设置唯一的路由前缀，让路由模板结构不同。示例修改如下：

// GET api/projecttask/ie/{ieId}
[HttpGet("ie/{ieId}")]
public async Task<ActionResult<ServiceResponse<List<ProjectTask>>>> GetProjectTasks(int ieId)
{
    var result = await _projectTaskService.GetProjectTasksAsync(ieId);
    return Ok(result);
}

// GET api/projecttask/{id}
[HttpGet("{id}")]
public async Task<ActionResult<ServiceResponse<ProjectTask>>> GetProjectTask(int id)
{
    var result = await _projectTaskService.GeProjectTaskAsync(id);
    return Ok(result);
}

或者反过来，给单个任务接口加前缀，让语义更明确：

// GET api/projecttask/{ieId}
[HttpGet("{ieId}")]
public async Task<ActionResult<ServiceResponse<List<ProjectTask>>>> GetProjectTasks(int ieId)
{
    var result = await _projectTaskService.GetProjectTasksAsync(ieId);
    return Ok(result);
}

// GET api/projecttask/task/{id}
[HttpGet("task/{id}")]
public async Task<ActionResult<ServiceResponse<ProjectTask>>> GetProjectTask(int id)
{
    var result = await _projectTaskService.GeProjectTaskAsync(id);
    return Ok(result);
}

为什么修改参数命名没用？ #

你尝试修改参数命名但无效，是因为ASP.NET Core的路由匹配逻辑不依赖参数名称，只关注路由模板的结构和占位符的类型约束（如果有的话）。两个接口的模板都是{int}，所以无论参数叫什么，路由系统都会认为它们是同一个模板。

其他可选方案（不推荐） #

如果不想修改路由结构，也可以尝试为参数添加路由约束，但这种方式可读性差，且如果ieId和任务id的取值范围有重叠，仍然会有问题：

// 假设ieId是1000以上的整数，任务id是1000以下
[HttpGet("{ieId:int:min(1000)}")]
public async Task<ActionResult<ServiceResponse<List<ProjectTask>>>> GetProjectTasks(int ieId)
{
    // ...
}

[HttpGet("{id:int:max(999)}")]
public async Task<ActionResult<ServiceResponse<ProjectTask>>> GetProjectTask(int id)
{
    // ...
}

这种方式仅适用于参数取值范围完全不重叠的场景，远不如修改路由前缀直观可靠。

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