.Net Core 6.0 API路由参数：查询字符串传参失效问题求助

方法一：合并端点处理两种参数传递方式 #

将获取单个员工和所有员工的逻辑合并到一个动作方法中，同时支持路由参数和查询字符串参数：

[ApiController]
[Route("employees")]
public class EmployeesController : ControllerBase
{
    private readonly IEmployeeService _employeeService;

    public EmployeesController(IEmployeeService employeeService)
    {
        _employeeService = employeeService;
    }

    [HttpGet("{id?}")]
    public IActionResult GetEmployees([FromRoute] string id, [FromQuery(Name = "id")] string queryId)
    {
        // 优先使用路由参数，无值则 fallback 到查询字符串参数
        var targetId = id ?? queryId;

        if (string.IsNullOrEmpty(targetId))
        {
            // 无ID参数时返回所有员工
            return Ok(_employeeService.GetAllEmployees());
        }

        // 有ID参数时返回单个员工
        var employee = _employeeService.GetEmployeeById(targetId);
        return employee != null ? Ok(employee) : NotFound();
    }
}

该方案的核心逻辑：

• 路由模板{id?}允许id路径段可选
• 通过[FromRoute]和[FromQuery(Name = "id")]分别捕获两种来源的参数
• 合并参数值后，根据是否存在ID执行对应业务逻辑

方法二：保持独立端点，调整路由匹配优先级 #

如果希望保留两个独立的动作方法，可以给获取单个员工的端点设置更高路由优先级，确保带查询字符串id的请求优先匹配：

[ApiController]
[Route("employees")]
public class EmployeesController : ControllerBase
{
    private readonly IEmployeeService _employeeService;

    public EmployeesController(IEmployeeService employeeService)
    {
        _employeeService = employeeService;
    }

    // 高优先级：匹配带路由参数或查询字符串id的请求
    [HttpGet("{id}")]
    [HttpGet(Order = 1)]
    public IActionResult GetEmployeeById(string id)
    {
        if (string.IsNullOrEmpty(id))
        {
            return BadRequest("ID参数不能为空");
        }

        var employee = _employeeService.GetEmployeeById(id);
        return employee != null ? Ok(employee) : NotFound();
    }

    // 低优先级：仅匹配无任何id参数的请求
    [HttpGet(Order = 2)]
    public IActionResult GetAllEmployees()
    {
        return Ok(_employeeService.GetAllEmployees());
    }
}

该方案的核心逻辑：

• 通过Order属性设置路由优先级，数值越小优先级越高
• 未指定绑定源的参数id会自动从路由段或查询字符串中匹配值
• 优先级更低的GetAllEmployees仅在无id参数时被匹配

方法三：简化参数绑定规则 #

如果不需要区分参数来源，仅需让id同时支持路由和查询字符串传递，可以直接省略绑定源属性，依赖.NET Core的自动匹配逻辑：

[HttpGet("{id?}")]
public IActionResult GetEmployeeById(string id)
{
    if (string.IsNullOrEmpty(id))
    {
        return NotFound();
    }
    var employee = _employeeService.GetEmployeeById(id);
    return employee != null ? Ok(employee) : NotFound();
}

此时访问/employees/001或/employees?id=001都会触发该方法，id参数会自动从对应来源获取值。

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