ASP.NET Core 8控制器路由歧义异常行为原因咨询

1. 公共方法的默认候选规则 #

ASP.NET Core控制器路由系统的默认逻辑是：所有控制器中的公共实例方法（排除继承自Controller基类的方法），都会被自动当作潜在的端点候选，不管你有没有给方法添加[HttpPost]这类HTTP特性。这个约定是为了简化路由配置，但也会把你不想暴露的公共方法（比如Foo()）纳入路由匹配池。

2. 可选参数路由的匹配逻辑 #

你的HttpPost方法配置了<HttpPost("{methName?}")>，当请求domain/controllerName时，methName作为可选参数可以为空，完全符合这个路由模板的匹配条件。但同时，那些没有HTTP特性的公共方法，框架会用默认的约定路由模板（{controller}/{action}/{id?}）去匹配——此时请求URL里没有action段，框架会把这些无特性的公共方法全部视为可能的action候选，因为没有明确的规则排除它们。

3. 路由歧义的触发原因 #

当处理domain/controllerName的POST请求时，框架发现多个候选端点都能匹配：

• 带<HttpPost("{methName?}")>的HttpPost方法：满足POST请求约束，且可选参数为空的条件。
• 无HTTP特性的公共方法：框架默认它们支持所有HTTP方法，同时约定路由下，空的action段会被认为可以匹配这些方法（因为没有明确指定action的匹配规则）。
  这种多候选匹配的情况，框架无法自动判定优先级，就会抛出路由歧义错误。

4. 带methName的请求无歧义的原因 #

当请求domain/controllerName/method时，methName参数被赋值为method，此时只有HttpPost方法的路由模板{methName?}能匹配这个URL结构。而无特性的公共方法需要URL中的action段等于方法名（比如Foo()需要请求domain/controllerName/Foo），所以不会被纳入候选池，自然不会出现歧义。

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