如何将API查询参数中的混合类型Filter映射到.NET控制器类参数？

针对你遇到的混合类型Filter参数无法直接绑定的问题，以下是两种实用的解决思路：

方案1：直接接收字符串并手动解析（最简方式） #

跳过自动绑定，先将filter作为字符串接收，再用Newtonsoft.Json的JArray解析混合类型结构：

控制器方法示例 #

[HttpGet("getCustomers")]
public IActionResult GetCustomers(int skip, int take, [FromQuery] string filter)
{
    if (!string.IsNullOrEmpty(filter))
    {
        try
        {
            // 解析混合类型数组
            var filterArray = JArray.Parse(filter);
            
            // 遍历处理每个元素
            foreach (var item in filterArray)
            {
                if (item.Type == JTokenType.Array)
                {
                    // 处理筛选条件（如["displayEmail1","contains","dan"]）
                    var conditionParts = item.ToObject<List<string>>();
                    string field = conditionParts[0];
                    string op = conditionParts[1];
                    string value = conditionParts[2];
                    // 这里添加你的条件逻辑
                }
                else if (item.Type == JTokenType.String)
                {
                    // 处理逻辑运算符（如"and"）
                    string logicOp = item.ToString();
                    // 这里添加逻辑符处理逻辑
                }
            }
        }
        catch (JsonException)
        {
            return BadRequest("Filter参数格式无效");
        }
    }
    
    // 后续业务逻辑
    return Ok();
}

方案2：自定义模型绑定器（强类型绑定） #

如果希望将filter直接绑定到查询参数类中，可以自定义模型绑定器，自动将字符串解析为JArray或强类型结构：

步骤1：定义查询参数类 #

public class CustomerQuery
{
    public int Skip { get; set; }
    public int Take { get; set; }
    
    // 使用自定义绑定器解析Filter
    [ModelBinder(BinderType = typeof(JArrayModelBinder))]
    public JArray Filter { get; set; }
}

步骤2：实现自定义模型绑定器 #

public class JArrayModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        if (bindingContext == null)
            throw new ArgumentNullException(nameof(bindingContext));

        var filterValue = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (filterValue == ValueProviderResult.None)
            return Task.CompletedTask;

        bindingContext.ModelState.SetModelValue(bindingContext.ModelName, filterValue);
        var filterString = filterValue.FirstValue;

        try
        {
            var jArray = JArray.Parse(filterString);
            bindingContext.Result = ModelBindingResult.Success(jArray);
        }
        catch (JsonException)
        {
            bindingContext.ModelState.TryAddModelError(bindingContext.ModelName, "Filter参数格式无效");
        }

        return Task.CompletedTask;
    }
}

步骤3：控制器方法使用强类型参数 #

[HttpGet("getCustomers")]
public IActionResult GetCustomers([FromQuery] CustomerQuery query)
{
    if (query.Filter != null)
    {
        // 遍历处理Filter数组，逻辑同方案1
        foreach (var item in query.Filter)
        {
            // 处理条件或逻辑符
        }
    }
    
    // 业务逻辑
    return Ok();
}

补充说明 #

你之前用List<IConvertible>反序列化失败的原因是：IConvertible是接口，Newtonsoft.Json无法推断具体的实现类型，无法实例化对象。改用JArray（Newtonsoft.Json的动态数组类型）可以完美兼容混合类型结构，后续也可以手动将JArray转换为自定义的强类型筛选模型（如FilterCondition和FilterLogicalOperator的抽象列表）。

内容的提问来源于stack exchange，提问作者Dan Stefan Cehan