ASP.NET Core MVC未显式传FromQuery字典时镜像所有查询参数问题

问题成因 #

这是ASP.NET Core模型绑定的默认设计行为：
当[FromQuery]修饰的Dictionary<string, List<string>>类型参数，没有在查询字符串中检测到与参数名（即这里的filters）匹配的前缀时，模型绑定器会回退到把整个查询字符串中所有的键值对全部绑定到该字典中，而不是返回null或空字典。
另外你当前项目的包版本存在不兼容问题：.NET Core 3.1对应的内置Microsoft.AspNetCore.Mvc版本为3.x系列，你额外引用2.2.0版本的Mvc包会引入潜在的绑定逻辑冲突，建议先对齐主版本号。

解决方案 #

• 方案1：强制指定绑定前缀
  给filters参数添加[Bind(Prefix = "filters")]特性，强制绑定器仅匹配以filters为前缀的查询参数，无匹配参数时会自动绑定为空字典，不会再读取其他全局查询参数：

[FromQuery] [CanBeNull] [Bind(Prefix = "filters")] Dictionary<string, List<string>> filters

• 方案2：封装为统一请求模型
  将所有查询参数封装为一个独立的请求类，字典作为类的属性，绑定器会自动按属性名匹配前缀，不会出现跨属性绑定的问题：

public class SearchRequest
{
    public int Skip { get; set; }
    public int PageSize { get; set; }
    public string SearchTerm { get; set; }
    public Dictionary<string, List<string>> Filters { get; set; }
}

// 控制器方法改写为
[HttpGet("search")]
public async Task<IActionResult> SearchAsync([FromQuery] SearchRequest request)

• 方案3：自定义字典参数绑定器
  如果需要未传filters参数时返回null而非空字典，可以实现自定义模型绑定器，检测到查询字符串中无filters前缀的参数时直接返回null即可。

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