ASP.NET Core中同时使用[Route]和带Name的[HttpGet]接口异常求助

1. 修正拼写错误 #

你的方法名和[HttpGet]的Name属性里都写了GetAvailabilitiesForPorducts——注意这里的Porducts少了一个字母r，正确拼写应为Products。虽然拼写错误不会直接触发路由失效，但可能干扰框架的路由元数据生成，建议先统一修正拼写。

2. 调整路由特性组合方式 #

同时使用[Route]和带Name的[HttpGet]时，推荐两种规范写法避免冲突：

方式一：合并路由模板到[HttpGet] #

去掉单独的[Route]，直接把路径整合到[HttpGet]中，同时保留命名路由：

[HttpGet("availability", Name = "GetAvailabilitiesForProducts")]
public async Task<ActionResult<IEnumerable<AvailabilityDTO>>> GetAvailabilitiesForProducts([FromQuery] AvailabilityResourceParams availabilityResourceParams)
{ ... }

这是ASP.NET Core属性路由的标准写法，能避免多路由特性叠加的优先级歧义。

方式二：给[HttpGet]指定空模板 #

如果必须保留[Route("availability")]，给[HttpGet]加上空模板，明确绑定GET请求：

[Route("availability")]
[HttpGet("", Name = "GetAvailabilitiesForProducts")]
public async Task<ActionResult<IEnumerable<AvailabilityDTO>>> GetAvailabilitiesForProducts([FromQuery] AvailabilityResourceParams availabilityResourceParams)
{ ... }

这种写法会让框架明确将[Route]的路径与[HttpGet]的请求方法绑定，消除匹配歧义。

3. 检查参数绑定规则 #

确认AvailabilityResourceParams类的所有查询参数都符合模型绑定规则，比如没有未正确配置绑定源的复杂类型。命名路由可能影响元数据生成，参数绑定异常也可能间接导致路由失效。

4. 启用路由调试定位问题 #

在Program.cs中添加路由调试日志，查看具体匹配过程：

builder.Logging.AddFilter("Microsoft.AspNetCore.Routing", LogLevel.Debug);

运行程序后，控制台会输出每个请求的路由匹配步骤，能直接定位到失败环节。

内容的提问来源于stack exchange，提问作者Simone D.