ASP.NET Core 5.0 REST API查询字符串参数无法生效问题

你的代码存在两个核心配置错误，导致按name查询的逻辑无法命中：

• 路由模板配置错误：第三个接口标注的[HttpGet("{name}")]是路径参数的声明方式，仅会匹配/api/v1/users/xxx这类路径格式，和你需要的?name=xxx查询字符串传参场景完全不匹配。查询字符串不需要写在路由模板中，仅靠参数绑定特性[FromQuery]即可识别。
• 路由匹配优先级问题：根路径的无参Get()方法路由模板和/api/v1/users/完全匹配，ASP.NET Core路由匹配时不会因为路径后带查询字符串就跳过该方法，因此你的带参请求直接被无参方法捕获。另外原代码中{id}和{name}两个路径段模板结构完全一致，框架无法自动区分，即使传路径参数也会出现匹配混乱。

直接删除原有的第三个错误配置的Get方法，将name参数合并到根路径Get接口中，同时给id路由增加类型约束避免匹配冲突，调整后代码如下：

// 匹配 GET /api/v1/users
// 匹配 GET /api/v1/users?name=xxx
[HttpGet]
public virtual async Task<IActionResult> Get([FromQuery] string? name = null)
{
    // 存在name参数时走按名称查询逻辑
    if (!string.IsNullOrWhiteSpace(name))
    {
        var nameMatchItem = await service.GetByUserId(name);
        if (nameMatchItem == null) return NotFound();
        return Ok(nameMatchItem);
    }

    // 无参数时返回全量列表
    var allItems = await service.GetAll();
    if (!allItems.Any()) return NotFound();
    return Ok(allItems);            
}

// 匹配 GET /api/v1/users/{id}，增加int类型约束，仅路径段为整数时命中该接口
[HttpGet("{id:int}")]
public virtual async Task<IActionResult> Get(int id)
{
    var item = await service.Get(id);
    if (item == null) return NotFound();
    return Ok(item);
}

• 移除了错误的{name}路径模板配置，name作为可选查询参数绑定到根路径接口，符合查询字符串传参的设计
• 给id路由增加int约束，框架会自动校验路径段类型，只有纯数字的路径段才会命中按id查询的接口，不会出现路由冲突
• 逻辑分支清晰：传name参数返回单条匹配数据，不传返回全量列表，符合REST接口设计规范

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