如何阻止[FromQuery]自动实例化对象？检测无查询参数的方法

问题原因 #

ASP.NET Core 中使用[FromQuery]绑定复杂类型（比如你的SearchCriteria）时，模型绑定器会自动实例化该对象——哪怕没有传入任何查询参数，所以searchCriteria永远不会是null，这是框架的默认设计行为。而移除[FromQuery]后，参数属于未指定绑定源的情况，框架不会自动实例化，没传参数时就会保持默认的null。

检测是否无查询参数的方法 #

方法一：直接检查请求的Query集合

最简单直接的方式是通过Request.Query判断是否存在任何查询参数：

[HttpGet, Route("")]
public async Task<IActionResult> Search([FromQuery] SearchCriteria? searchCriteria = null)
{
    if (Request.Query.Count == 0)
    {
        // 处理完全没有收到查询参数的逻辑
        return Ok("未传入任何查询参数");
    }

    // 正常处理带参数的逻辑
    // ...
}

方法二：检查模型属性是否全为默认值（有局限性）

如果担心Request.Query可能包含空值参数（比如api/search?name=），可以检查SearchCriteria的所有属性是否都是默认值，但这种方法只适用于属性默认值和用户传入的有效值不会混淆的场景。比如写一个扩展方法：

public static bool IsAllDefault<T>(this T obj) where T : new()
{
    var defaultObj = new T();
    foreach (var prop in typeof(T).GetProperties())
    {
        if (!Equals(prop.GetValue(obj), prop.GetValue(defaultObj)))
        {
            return false;
        }
    }
    return true;
}

然后在Action中使用：

if (searchCriteria.IsAllDefault())
{
    // 处理无有效参数的逻辑
}

注意：如果用户传入的参数刚好等于属性默认值（比如int类型的PageIndex=0），这种方法会误判为无参数。

方法三：拆分单个查询参数（适用于参数少的场景）

如果查询参数不多，可以把SearchCriteria拆成单个参数，没传的话参数就是默认值，能直接判断：

[HttpGet, Route("")]
public async Task<IActionResult> Search([FromQuery] string? keyword = null, [FromQuery] int? pageIndex = null)
{
    if (keyword == null && pageIndex == null)
    {
        // 无查询参数的逻辑
    }
    // 组装成SearchCriteria对象处理
    var searchCriteria = new SearchCriteria { Keyword = keyword, PageIndex = pageIndex ?? 0 };
    // ...
}

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