ASP.NET Core控制器Action重载路由异常问题求助

你的问题出在路由模板和参数不匹配，以及重载Action的路由模糊匹配上——现有项目路由规则更多，冲突概率远高于空白项目，才会出现跳错控制器的情况。

具体错误点 #

• 第二个Action的路由模板[HttpGet("{ParentID}")]和参数名Parent不匹配，模型绑定无法正确关联路由参数，导致路由系统无法精准识别这个Action。
• 两个Index重载都是GET请求，且路由规则没有明确区分，现有项目中其他控制器的路由规则优先级更高时，就会被错误匹配。
• 第二个Action的Mode参数是必填的，但路由模板里没有定义，只能通过查询参数传递，进一步增加了路由匹配的模糊性。

修正方案 #

方案一：明确路由模板与参数匹配，区分重载路由

修改第二个Action的路由，让路由参数和方法参数名一致，同时给两个Action设置明确的路由区分：

// 第一个Action：匹配 /控制器名/Index 或 /控制器名/Index?id=xxx
[HttpGet("Index/{id:int?}")]
public async Task<IActionResult> Index(int? id)
{
    return View("~/Views/File_System/Folder_File_System/Index.cshtml", await _context.ToListAsync());
}

// 第二个Action：匹配 /控制器名/Index/123/true 或 /控制器名/Index/123?Mode=true
[HttpGet("Index/{Parent:int}/{Mode:bool}")]
public async Task<IActionResult> Index(int Parent, bool Mode)
{
    return View("~/Views/File_System/Folder_File_System/Index.cshtml", await _context.ToListAsync());
}

方案二：使用参数来源标记+路由约束

如果不想修改路由结构，给参数加上来源标记明确参数来源，同时给路由添加类型约束避免模糊匹配：

public async Task<IActionResult> Index(int? id)
{
    return View("~/Views/File_System/Folder_File_System/Index.cshtml", await _context.ToListAsync());
}

[HttpGet("{Parent:int}")]
public async Task<IActionResult> Index([FromRoute] int Parent, [FromQuery] bool Mode)
{
    return View("~/Views/File_System/Folder_File_System/Index.cshtml", await _context.ToListAsync());
}

方案三：放弃重载，改用不同Action名称

如果路由冲突难以排查，直接给第二个Action起不同名称，避免重载带来的匹配问题：

public async Task<IActionResult> Index(int? id)
{
    return View("~/Views/File_System/Folder_File_System/Index.cshtml", await _context.ToListAsync());
}

[HttpGet("IndexByParent/{Parent:int}")]
public async Task<IActionResult> IndexByParent(int Parent, bool Mode)
{
    return View("~/Views/File_System/Folder_File_System/Index.cshtml", await _context.ToListAsync());
}

额外注意 #

现有项目中如果使用了区域(Area)、路由前缀或者第三方路由组件，需要确认这些配置是否和你的Action路由产生冲突。必要时可以给控制器添加[Route("Folder")]这类前缀特性，让所有Action路由都基于这个前缀，避免和其他控制器冲突。

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