这个问题的核心在于ASP.NET Core的路由匹配规则：路由系统首先匹配URL路径部分，而Query参数（比如?id=1）不会参与路由模板的匹配，只会在路由确定后进行参数绑定。

你的第一个[HttpGet] Action的路由模板是空的，完全匹配/api/orders路径；而第二个[HttpGet("{id:int}")]的路由模板要求路径必须是/api/orders/{id}格式（比如/api/orders/1）。所以当你请求/api/orders?id=1时，路径部分还是/api/orders，系统会优先匹配第一个Action——因为第一个Action的参数是可选的（有默认值），系统认为它可以处理这个请求（忽略额外的Query参数）。

下面提供几种解决方案，你可以根据自己的需求选择：

方案1：合并Action，统一处理两种请求格式 #

把两个Action合并成一个，通过判断id参数是否存在来分支处理，这样无需纠结路由匹配问题：

[HttpGet("{id:int?}")] // ? 标记id为可选路径参数
public IActionResult Get(int? id, bool includeItems = true)
{
    if (id.HasValue)
    {
        // 处理根据id查询订单的逻辑
        var order = _repository.GetOrderById(id.Value);
        return order != null 
            ? Ok(_mapper.Map<Order, OrderViewModel>(order)) 
            : NotFound();
    }
    else
    {
        // 处理查询所有订单的逻辑
        var results = _repository.GetAllOrders(includeItems);
        return Ok(_mapper.Map<IEnumerable<Order>, IEnumerable<OrderViewModel>>(results));
    }
}

这样无论是/api/orders/1（路径参数）还是/api/orders?id=1（Query参数），都会触发单订单查询逻辑；而/api/orders或/api/orders?includeItems=false则会返回所有订单。

方案2：给“查询所有”的Action指定明确路由 #

修改第一个Action的路由，让它只能通过特定路径访问，比如/api/orders/all，从根源上区分两种请求：

// 查询所有订单的Action，绑定到/api/orders/all路径
[HttpGet("all")]
public IActionResult GetAll(bool includeItems = true)
{
    var results = _repository.GetAllOrders(includeItems);
    return Ok(_mapper.Map<IEnumerable<Order>, IEnumerable<OrderViewModel>>(results));
}

// 根据id查询的Action，同时支持路径参数和Query参数
[HttpGet("{id:int}")]
[HttpGet] // 添加该特性，让它匹配/api/orders路径，处理?id=1的请求
public IActionResult GetById([FromQuery] int id)
{
    var order = _repository.GetOrderById(id);
    return order != null 
        ? Ok(_mapper.Map<Order, OrderViewModel>(order)) 
        : NotFound();
}

这样：

• api/orders/all或api/orders/all?includeItems=false → 匹配GetAll
• api/orders/1或api/orders?id=1 → 匹配GetById

方案3：用自定义Action约束区分请求 #

如果你想保留两个独立的Action，又不想修改路由路径，可以创建一个自定义约束，让系统在Query参数包含id时自动选择第二个Action：

1. 定义约束类：

using Microsoft.AspNetCore.Mvc.ActionConstraints;

public class QueryParameterExistsAttribute : ActionMethodSelectorAttribute
{
    private readonly string _parameterName;

    public QueryParameterExistsAttribute(string parameterName)
    {
        _parameterName = parameterName;
    }

    public override bool IsValidForRequest(RouteContext routeContext, ActionDescriptor action)
    {
        return routeContext.HttpContext.Request.Query.ContainsKey(_parameterName);
    }
}

2. 给第二个Action添加约束：

[HttpGet]
[QueryParameterExists("id")] // 仅当Query包含id参数时，匹配该Action
public IActionResult Get([FromQuery] int id)
{
    var order = _repository.GetOrderById(id);
    if (order != null)
        return Ok(_mapper.Map<Order, OrderViewModel>(order));
    else
        return NotFound();
}

这样当请求的Query里包含id参数时，系统会优先选择这个Action；否则自动匹配第一个查询所有订单的Action。

内容的提问来源于stack exchange，提问作者Abhishek Kr Jha