ASP.NET Core API URL携带查询参数时如何正确触发带参接口

路由匹配不生效的核心是对ASP.NET Core路由规则的理解偏差，具体有三点：

• 路由模板仅匹配URL中问号之前的路径段，问号后附带的?name=Spider属于查询字符串，完全不参与路由匹配逻辑。哪怕路由模板里写了name={term}，也只会匹配路径里的对应内容，不会识别查询串里的同名参数。
• 第二个方法上配置的[HttpGet("/name={term}")]，开头的斜杠代表从应用根路径开始匹配，这个模板实际可命中的URL是https://localhost:44375/name=Spider，和你请求的/heroes路径完全不在同一匹配范围。
• 你请求的路径部分是/heroes，第一个无参方法上的[HttpGet]没有自定义路径模板，会匹配控制器对应的默认路由（也就是/heroes路径），查询字符串的存在不会改变路径匹配结果，因此框架直接命中了第一个无参方法。

根据你想要的URL使用习惯，分两种场景修改：

方案1：保留现有查询字符串传参格式（即继续使用/heroes?name=Spider这类URL） #

需要修改第二个方法的路由配置，让两个方法匹配同一个/heroes路径，通过查询串绑定区分逻辑：

1. 去掉第二个方法上错误的根路径模板/name={term}
2. 明确参数绑定来源，通过路由排序消除同路径的匹配歧义：

   // 低优先级：无参方法，请求不带对应查询参数时兜底匹配
   [HttpGet(Order = 1)]
   public IEnumerable<Hero> Get()
   {
       return Heroes;
   }
   
   // 高优先级：带参方法，请求携带对应查询参数时优先匹配
   [HttpGet(Order = 0)]
   public IEnumerable<Hero> Get([FromQuery] string term)
   {
       return Heroes;
   }
   

   实际开发更推荐合并逻辑，避免同路径方法重载带来的不必要歧义：

   [HttpGet]
   public IEnumerable<Hero> Get([FromQuery] string? term = null)
   {
       // 有参数就做过滤，没参数就返回全量
       return string.IsNullOrEmpty(term) ? Heroes : Heroes.Where(h => h.Name.Contains(term));
   }
   

方案2：保留当前路径传参的路由模板（即沿用name={term}的路径风格） #

需要调整请求URL的格式，不要再用带问号的查询串传参，直接把参数放到路径段中，也就是请求：
https://localhost:44375/name=Spider
这个URL的路径部分完全匹配第二个方法配置的/name={term}模板，就会直接触发带参的Get方法。

如果你希望路径参数挂在/heroes路由下，需要把模板调整为[HttpGet("~/heroes/name={term}")]，对应的请求URL就会变成https://localhost:44375/heroes/name=Spider。

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