ASP.NET Core无模型绑定场景下从IQueryCollection读取GET数组参数

安全阿岳

2026-9-30

问题根因

前端将数组序列化为查询字符串时，会自动给数组字段的键名添加[]后缀，你尝试读取的items键实际不存在，正确键名为items[]
HttpUtility.ParseQueryString属于System.Web类库，和ASP.NET Core原生的IQueryCollection适配性不佳，优先直接用Request.Query读取参数

实现方案

1. 直接读取指定参数生成匿名对象

// 读取数组并转换为int类型
int[] items = Request.Query["items[]"].Select(int.Parse).ToArray();
// 读取并解析日期，可根据需求增加时区转换逻辑
DateTime startDate = DateTime.Parse(Request.Query["startDate"]).ToUniversalTime();
DateTime endDate = DateTime.Parse(Request.Query["endDate"]).ToUniversalTime();

// 生成所需匿名对象
var queryParams = new
{
    Items = items,
    StartDate = startDate,
    EndDate = endDate
};

2. 通用动态读取方案（适配参数结构不固定场景）

如果参数复杂度高、结构不固定，可以用扩展方法把整个查询参数转为动态对象，不需要提前定义字段：

public static class QueryCollectionExtensions
{
    public static dynamic ToDynamic(this IQueryCollection query)
    {
        IDictionary<string, object> expando = new ExpandoObject();
        foreach (var key in query.Keys)
        {
            // 自动去掉数组键名的[]后缀
            var cleanKey = key.EndsWith("[]") ? key[0..^2] : key;
            var values = query[key];
            // 单值直接返回，多值返回字符串数组
            expando[cleanKey] = values.Count == 1 ? values[0] : values.ToArray();
        }
        return expando;
    }
}

调用示例：

dynamic queryParams = Request.Query.ToDynamic();
// 直接通过字段名取值即可
int[] items = ((IEnumerable<string>)queryParams.items).Select(int.Parse).ToArray();
DateTime startDate = DateTime.Parse(queryParams.startDate);

避坑提示