.NET项目API访问报AmbiguousMatchException错误的解决方法

这个AmbiguousMatchException异常的核心是：AspNetCore的路由系统检测到同一个请求（GET /Api/MerchantApi/List）匹配到了两个完全相同的端点，无法确定应该路由到哪个方法，因此抛出冲突错误。

从你提供的代码和异常信息来看，可能存在以下几种情况：

• 项目中存在两个或多个方法使用了完全相同的路由路径+HTTP方法（异常显示两个匹配项都是GET /Api/MerchantApi/List）；
• 代码中控制器的路由前缀与方法路由叠加后，出现了重复的路由组合；
• 自定义的[Api]路由属性未明确指定HTTP方法，导致路由匹配逻辑模糊。

1. 为API方法显式指定HTTP动词 #

默认情况下，如果不标注[HttpGet]/[HttpPost]等属性，路由系统可能会将方法匹配所有HTTP动词，容易引发冲突。给每个API方法添加明确的HTTP动词属性，让路由匹配更精准：

[HttpGet("Api/MerchantData/Page")]
public PageResult<MerchantDataList> Page(MerchantDataListInput input)
{
    // 原有业务逻辑不变
}

[HttpGet("Api/MerchantData/List")]
public List<MerchantDataList> List(MerchantDataListInput input){
    var pageResult = Page(input);
    var result = pageResult.Result;
    return result;
}

2. 排查并消除重复路由 #

• 全局搜索项目中是否存在其他方法使用了/Api/MerchantApi/List路由（注意异常中的MerchantApi与代码中的MerchantData可能是控制器路由前缀的差异）；
• 如果控制器类设置了路由前缀（比如[Route("Api/MerchantApi")]），方法路由应使用相对路径，避免叠加后重复：

[Route("Api/MerchantData")]
public class MerchantDataController : ControllerBase
{
    [HttpGet("Page")]
    public PageResult<MerchantDataList> Page(MerchantDataListInput input)
    {
        // ...
    }

    [HttpGet("List")]
    public List<MerchantDataList> List(MerchantDataListInput input)
    {
        // ...
    }
}

这种设置下，组合后的路由为/Api/MerchantData/Page和/Api/MerchantData/List，不会产生冲突。

3. 替换自定义路由属性（若有需要） #

如果代码中的[Api]是自定义路由属性，检查其内部实现是否存在路由重复注册的问题。建议直接使用AspNetCore官方提供的[HttpGet]/[HttpPost]等属性，避免自定义属性带来的匹配模糊问题。

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