.NET7中向REST端点传递对象数组失败的问题排查

1. 修正QueryString格式（核心问题） #

你当前的URL格式Filters={"field"="string","value"="string"}不符合.NET默认模型绑定的解析规则，框架无法将这种JSON格式字符串自动映射为Filtration数组。正确格式有两种：

索引式（语义清晰，推荐） #

https://localhost:7101/user/list?Filters[0].Field=string&Filters[0].Value=string&Filters[1].Field=string&Filters[1].Value=string

无索引式（框架自动组装数组） #

https://localhost:7101/user/list?Filters.Field=string&Filters.Value=string&Filters.Field=string&Filters.Value=string

2. 验证基础绑定逻辑 #

先排除单个对象/简单数组的绑定问题：

• 测试单个Filtration对象：请求https://localhost:7101/user/list?Donkey.Field=test&Donkey.Value=test，检查Donkey属性是否正确赋值。
• 测试字符串数组：请求https://localhost:7101/user/list?Monkey=val1&Monkey=val2，确认Monkey数组能正常填充。
  若这两项都正常，说明模型绑定基础逻辑没问题，问题仅出在对象数组的格式上。

3. 检查自定义模型绑定配置 #

确认项目中没有自定义绑定器干扰默认逻辑：

• 查看Program.cs中AddControllers的配置，是否修改过ModelBinderProviders、SuppressImplicitRequiredAttributeForNonNullableReferenceTypes等设置，这些可能影响绑定行为。
• 若使用了自定义模型绑定器，检查是否覆盖了数组类型的绑定逻辑。

4. 启用模型绑定日志排查细节 #

在appsettings.json中添加日志配置，查看绑定过程的详细错误：

{
  "Logging": {
    "LogLevel": {
      "Microsoft.AspNetCore.Mvc.ModelBinding": "Debug"
    }
  }
}

启动项目后，查看控制台或日志文件，搜索ModelBinding相关内容，可看到参数是否被接收、绑定失败的具体原因（如参数名称不匹配、类型转换错误等）。

5. 修正Swagger配置（若依赖Swagger生成请求） #

如果Swagger生成的URL格式不符合要求，可添加自定义参数过滤器调整：
在Program.cs的Swagger配置中添加：

builder.Services.AddSwaggerGen(options =>
{
    options.ParameterFilter<ArrayParameterFilter>();
});

// 自定义过滤器，处理对象数组的QueryString格式
public class ArrayParameterFilter : IParameterFilter
{
    public void Apply(OpenApiParameter parameter, ParameterFilterContext context)
    {
        if (parameter.In == ParameterLocation.Query 
            && parameter.Schema.Type == "array" 
            && parameter.Schema.Items?.Reference != null)
        {
            parameter.Name = $"{parameter.Name}[0].Field";
            parameter.Schema = null;
        }
    }
}

配置后Swagger会生成符合.NET绑定规则的QueryString参数格式。

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