.NET Core中基控制器与派生控制器的AmbiguousMatchException问题

为什么会出现路由冲突？ #

你的ControllerBase是一个可被ASP.NET Core路由系统扫描到的控制器类——它继承了Controller/ControllerBase，同时带有[Route]和[ApiController]特性，路由系统会将它当作独立控制器注册端点。而ProductsController继承ControllerBase后，会完全继承基类的xxxx方法及其路由配置，导致路由系统同时注册了两个api/xxxx端点：

• 来自基控制器ControllerBase本身的xxxx方法
• 来自派生控制器ProductsController继承的xxxx方法

这就是触发AmbiguousMatchException的根本原因。

解决方法（满足现有路由格式需求） #

将基控制器改为抽象类，ASP.NET Core的控制器激活系统会忽略抽象类，不会将其当作独立控制器注册端点，仅会处理派生的ProductsController：

[Route("api/[action]")]
[ApiController]
// 添加abstract关键字
public abstract class ControllerBase : Microsoft.AspNetCore.Mvc.Controller
{   
    [HttpGet]
    public List<Product> xxxx()
    {
        return products.ToList(); 
    }
    // ...其他基类代码
}

修改后，api/xxxx端点只会由ProductsController继承的方法提供，同时api/GetAllProducts也能正常访问，完全符合你保留原有路由格式的要求。

关于基类与派生类同名方法的情况 #

• 如果派生类未用override重写基类同名方法：路由系统会同时注册基类和派生类的两个同名action端点，依然会触发路由冲突。
• 如果派生类用override重写了基类方法：
  • 若派生类方法未添加额外路由特性，会覆盖基类的路由配置，仅注册派生类的端点；
  • 若派生类方法也添加了路由特性，会再次出现路由冲突，需要通过修改路由模板、添加路由约束等方式区分端点。

你尝试过的方案无效的原因 #

• 切换基类继承Controller或ControllerBase不影响：只要基类是可实例化的控制器类，就会被路由系统扫描注册；
• 添加/移除[ApiController]特性不影响：该特性主要是增强API控制器的行为，不会改变控制器被扫描注册的逻辑。

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