.NET Core Web API接口兼容路由与查询参数问题

能否让同一个端点同时支持两种调用方式？ #

可以实现，但需要调整路由配置和参数绑定逻辑，具体方案如下：

• 调整第二个GetStudent方法的路由模板，将路由参数设为可选：

  [HttpGet("{Id:int?}")]
  public ActionResult<Student> GetStudent([FromRoute, FromQuery] int? Id)
  {
      if (!Id.HasValue || Id <= 0)
          return BadRequest();
    
      return Ok(studentRepository.GetStudent(Id.Value));
  }
  

  配置后，该端点既能响应/api/Student/{Id}的路由参数请求，也能处理/api/Student?Id={Id}的查询字符串请求。
• 或者移除[Route("{Id}")]特性，仅保留[HttpGet]，同时保留[FromRoute, FromQuery]参数标记（需注意处理与GetStudents的路由冲突，比如通过参数是否存在来区分请求）。

.NET Framework Web API可行但.NET Core不可行的原因 #

两者的差异源于路由系统和参数绑定逻辑的设计不同：

• .NET Framework Web API：基于旧版System.Web.Routing，参数绑定规则宽松，允许同一个参数同时从路由、查询字符串等多种来源获取。路由匹配时，只要参数能被正确绑定，即使请求URL与路由模板不完全匹配（比如用查询字符串替代路由参数），也能匹配到对应端点。
• .NET Core Web API：引入了[ApiController]特性，默认启用严格路由绑定和自动参数源推断功能。当方法上存在[Route("{Id}")]时，路由系统会要求URL必须包含路由参数Id，否则会匹配到其他符合条件的端点（比如无参数的GetStudents）。同时，即使参数标记了[FromRoute, FromQuery]，在严格路由模式下，系统会优先验证路由参数是否存在，导致查询字符串请求无法匹配到该端点。

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