为何ASP.NET Web控制器接收的discriminatorTags为空列表？

核心问题原因 #

Get请求的查询参数是键值对结构，ASP.NET Core默认的模型绑定不会解析JSON格式的查询参数，这就是你用Swagger生成的JSON格式参数始终得到空列表的原因。需要改用符合模型绑定规则的键值对格式传递复杂对象列表。

正确的URL参数格式 #

针对List<DiscriminatorTags>类型的参数，有两种可被ASP.NET Core正确解析的格式：

1. 索引式格式（兼容性最好） #

通过下标索引区分列表中的不同对象，每个对象的属性用[索引].属性名的形式指定：

https://your-api-domain/searchall?searchterm=laptop&currentpage=1&pagesize=6&hasEst=true&discriminatorTags[0].Discriminator=ProductType&discriminatorTags[0].Selected=true&discriminatorTags[0].Tags[0]=5&discriminatorTags[0].Tags[1]=8&discriminatorTags[1].Discriminator=Brand&discriminatorTags[1].Selected=false&discriminatorTags[1].Tags[0]=12

• discriminatorTags[0]代表列表中的第一个DiscriminatorTags对象
• Tags[0]、Tags[1]对应对象中Tags列表的元素

2. 重复键式格式（ASP.NET Core 3.1+支持） #

无需指定索引，直接重复参数名来传递多个对象的属性：

https://your-api-domain/searchall?searchterm=laptop&currentpage=1&pagesize=6&hasEst=true&discriminatorTags.Discriminator=ProductType&discriminatorTags.Selected=true&discriminatorTags.Tags=5&discriminatorTags.Tags=8&discriminatorTags.Discriminator=Brand&discriminatorTags.Selected=false&discriminatorTags.Tags=12

• 相同属性名的参数会被自动分组为同一个对象，属性值按顺序匹配

额外优化建议 #

1. 将结构体改为类（避免值类型绑定问题） #

结构体是值类型，在模型绑定过程中可能出现意外的实例化问题，建议将DiscriminatorTags改为类，并显式添加无参构造函数：

public class DiscriminatorTags : IDiscriminatorTags
{
    // 显式声明无参构造函数，供模型绑定使用
    public DiscriminatorTags() { }

    public DiscriminatorTags(List<int> tags, string discriminator, bool selected)
    {
        this.Tags = tags;
        this.Discriminator = discriminator;
        this.Selected = selected;
    }

    [Required]
    public List<int> Tags { get; set; }
    [Required]
    public string Discriminator { get; set; }
    [Required]
    public bool Selected { get; set; }
}

2. 验证参数编码 #

如果Discriminator等属性包含特殊字符（如空格、&、=），需要对参数值进行URL编码，例如将Product Type编码为Product%20Type。

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