继承BaseController时请求匹配多个端点的问题求助

你遇到的**"The request matched multiple endpoints"错误，核心原因是基类与子类的Edit方法签名不一致，导致路由系统匹配到多个同名端点**：

• 基类BaseController中的Edit方法是无参数的：public virtual IActionResult Edit()
• 子类ProjectController中的Edit方法带int id参数：public override IActionResult Edit(int id)

这并不是真正的方法重写（重写要求方法签名完全一致），而是子类新增了一个重载的Edit方法。此时你的ProjectController实际上存在两个可被路由匹配的Edit端点：

1. 继承自基类的无参Edit方法
2. 子类自定义的带参Edit方法

当权限校验不通过时，基类的无参Edit会返回重定向，但路由系统已经同时匹配到两个端点，因此抛出冲突错误。

1. 统一基类与子类的方法签名 #

修改基类的Edit、Delete方法，添加可选参数，保证子类可以正确重写：

public class BaseController : Controller
{
    // ... 其他代码不变

    public virtual IActionResult Add()
    {
        if (!ControllerPermission.IsAdd)
        {
            return RedirectToPage("/NotAllowed");
        }

        return NoContent();
    }

    // 修改为带可选参数的签名
    public virtual IActionResult Edit(int? id = null)
    {
        if (!ControllerPermission.IsEdit)
        {
            return RedirectToAction("Index", "Project");
        }

        return NoContent();
    }

    // 修改为带可选参数的签名
    public virtual IActionResult Delete(int? id = null)
    {
        if (!ControllerPermission.IsDelete)
        {
            return RedirectToPage("/NotAllowed");
        }

        return NoContent();
    }
}

2. 子类重写方法时处理基类返回值 #

在子类的重写方法中，先调用基类方法并校验返回值：如果基类已经返回了重定向（无权限），则直接返回该结果，不再执行后续业务逻辑。

以ProjectController的Edit方法为例：

public override IActionResult Edit(int? id = null)
{
    // 先执行基类的权限校验，若返回非NoContent则直接返回（比如无权限的重定向）
    var baseResult = base.Edit(id);
    if (!(baseResult is NoContentResult))
    {
        return baseResult;
    }

    // 有权限时才执行后续业务逻辑
    if (Request.Method == "POST" && Project != null)
    {
        if (ModelState.IsValid)
        {
            _unitOfWork.Project.Update(Project);
            _unitOfWork.Save();
            return RedirectToAction("Index");
        }
    }
    else if (id.HasValue)
    {
        Project = _unitOfWork.Project.GetFirstOrDefault(x => x.Id == id.Value);
    }

    // 返回编辑视图（原代码最后重定向到Index是错误的，会导致正常编辑也跳走）
    return View(Project);
}

同理，修正Add和Delete方法的逻辑，避免无权限时继续执行后续代码：

public override IActionResult Add()
{
    var baseResult = base.Add();
    if (!(baseResult is NoContentResult))
    {
        return baseResult;
    }

    if (Request.Method == "POST" && Project != null)
    {
        if (ModelState.IsValid)
        {
            _unitOfWork.Project.Add(Project);
            _unitOfWork.Save();
            return RedirectToAction("Index");
        }
    }

    return View(Project);
}

public override IActionResult Delete(int? id = null)
{
    var baseResult = base.Delete(id);
    if (!(baseResult is NoContentResult))
    {
        return baseResult;
    }

    if (Request.Method == "POST" && Project != null)
    {
        if (ModelState.IsValid)
        {
            _unitOfWork.Project.Remove(Project);
            _unitOfWork.Save();
            return RedirectToAction("Index");
        }
    }
    else if (id.HasValue)
    {
        Project = _unitOfWork.Project.GetFirstOrDefault(x => x.Id == id.Value);
    }

    return View(Project);
}

3. 额外优化：权限校验逻辑提前 #

可以考虑将权限校验放在OnActionExecuting过滤器中，这样无需在每个方法中重复调用基类方法，更符合ASP.NET MVC的最佳实践：

public class BaseController : Controller
{
    protected readonly IUnitOfWork _unitOfWork;
    protected ControllerPermission ControllerPermission { get; set; }
    private string controllerName;

    public BaseController(IUnitOfWork unitOfWork)
    {
        _unitOfWork = unitOfWork;
        controllerName = this.GetType().Name[..^10];
        ControllerPermission = _unitOfWork.ControllerPermission.GetFirstOrDefault(
           x => x.Name == controllerName);
    }

    protected override void OnActionExecuting(ActionExecutingContext context)
    {
        base.OnActionExecuting(context);

        var actionName = context.ActionDescriptor.ActionName;
        bool hasPermission = actionName switch
        {
            "Add" => ControllerPermission.IsAdd,
            "Edit" => ControllerPermission.IsEdit,
            "Delete" => ControllerPermission.IsDelete,
            _ => true // 其他方法默认允许访问
        };

        if (!hasPermission)
        {
            if (actionName == "Edit")
            {
                context.Result = RedirectToAction("Index", "Project");
            }
            else
            {
                context.Result = RedirectToPage("/NotAllowed");
            }
        }
    }

    // 基类中可以移除原来的Add/Edit/Delete虚拟方法，子类直接实现业务逻辑即可
}

这样子类的方法无需再处理权限校验，只需专注业务逻辑，同时从根源避免了路由端点冲突的问题。

内容的提问来源于stack exchange，提问作者Yousif Al-Zoubi