自定义Model Binding结合集合绑定：手动绑定List字段问题

1. 确认请求体格式匹配 #

• 如果是JSON请求，确保Tags字段是数组结构，且请求头Content-Type为application/json：

  {
    "Email": "user@example.com",
    "Tags": ["tag1", "tag2"]
    // 若Tag是复杂对象："Tags": [{"Name":"tag1"}, {"Name":"tag2"}]
  }
  

• 如果是表单提交，需按索引命名字段，比如Tags[0]、Tags[1]，表单数据示例：

  Email=user@example.com&Tags[0]=tag1&Tags[1]=tag2
  

2. 修正自定义Model Binder的读取逻辑 #

避免手动解析字符串，直接利用序列化工具或ValueProvider正确读取集合：

针对JSON请求的示例代码： #

public async Task BindModelAsync(ModelBindingContext bindingContext)
{
    var request = bindingContext.HttpContext.Request;
    request.EnableBuffering(); // 允许重复读取请求体

    // 读取完整请求体并反序列化
    using var reader = new StreamReader(request.Body, leaveOpen: true);
    var requestBody = await reader.ReadToEndAsync();
    request.Body.Position = 0; // 重置流位置，避免后续中间件报错

    var person = JsonSerializer.Deserialize<Person>(requestBody);
    // 若需手动覆盖普通字段，可单独读取
    person.Email = bindingContext.ValueProvider.GetValue("Email").FirstValue ?? person.Email;

    bindingContext.Result = ModelBindingResult.Success(person);
}

针对表单提交的示例代码： #

public Task BindModelAsync(ModelBindingContext bindingContext)
{
    var person = new Person();
    person.Email = bindingContext.ValueProvider.GetValue("Email").FirstValue;

    // 遍历读取Tags集合
    var tags = new List<string>();
    int index = 0;
    while (true)
    {
        var tagValue = bindingContext.ValueProvider.GetValue($"Tags[{index}]").FirstValue;
        if (string.IsNullOrEmpty(tagValue)) break;
        tags.Add(tagValue);
        index++;
    }
    person.Tags = tags;

    bindingContext.Result = ModelBindingResult.Success(person);
    return Task.CompletedTask;
}

3. 检查Tag类的定义 #

确保Tag类（或List<T>的泛型类型）是public，且属性拥有public的getter和setter：

public class Tag
{
    public string Name { get; set; } // 必须包含get、set访问器
}

4. 验证Model Binder的全局注册 #

确认Program.cs中的注册逻辑正确，确保自定义Provider被优先加载：

builder.Services.AddControllers(options =>
{
    // 插入到Provider列表首位，确保优先使用自定义Binder
    options.ModelBinderProviders.Insert(0, new PersonModelBinderProvider());
});

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