通过jQuery AJAX向.NET控制器提交含嵌套数组的对象时绑定异常

这种嵌套对象数组绑定失败的情况我之前踩过好几次坑，大概率是这几个细节没处理到位，咱们一步步排查：

1. 检查前后端DTO属性的名称匹配（重点注意大小写） #

.NET默认使用PascalCase（首字母大写）命名属性，而前端JSON通常是camelCase（首字母小写），如果没配置自动映射，就会导致绑定失败。另外要确保嵌套类的属性有公共的get和set方法，不能是私有或者只读的。

举个例子：
前端JSON里的Keys数组对象：

{ "keyId": 1, "keyValue": "testValue" }

后端对应的嵌套DTO类应该是：

public class KeyDto
{
    // 首字母大写，和前端的keyId对应（配置驼峰映射后会自动匹配）
    public int KeyId { get; set; } 
    public string KeyValue { get; set; }
}

public class ACDto
{
    public List<KeyDto> Keys { get; set; }
    // 其他业务属性...
}

2. 修正AJAX请求的contentType和数据格式 #

如果直接传JavaScript对象，jQuery会默认转成x-www-form-urlencoded格式，这种格式对嵌套数组的支持很差。必须把数据转成JSON字符串，同时指定请求的contentType为application/json。

❌ 错误写法：

$.ajax({
    url: '/YourController/YourAction',
    type: 'POST',
    data: acDtoObject, // 直接传对象，自动转成form-urlencoded
    success: function(res) { /* ... */ }
});

✅ 正确写法：

$.ajax({
    url: '/YourController/YourAction',
    type: 'POST',
    contentType: 'application/json; charset=utf-8', // 必须指定JSON类型
    data: JSON.stringify(acDtoObject), // 把对象转成JSON字符串
    success: function(res) { /* ... */ }
});

3. 控制器Action必须添加[FromBody]特性 #

对于POST的JSON数据，.NET需要明确告知从请求体中读取数据，否则会尝试从表单或URL参数绑定，导致嵌套数组无法识别。

控制器代码示例：

[HttpPost]
public IActionResult YourAction([FromBody] ACDto model) // 必须加[FromBody]
{
    if (ModelState.IsValid)
    {
        // 处理业务逻辑
        return Ok();
    }
    return BadRequest(ModelState);
}

4. 旧版本.NET项目的额外配置（.NET Framework） #

如果你的项目是.NET Framework（不是.NET Core/.NET 5+），需要在WebApiConfig中配置JSON格式化器的驼峰映射：

config.Formatters.JsonFormatter.SerializerSettings.ContractResolver = 
    new Newtonsoft.Json.Serialization.CamelCasePropertyNamesContractResolver();

.NET Core及以上版本默认已经支持驼峰映射，除非你手动修改过序列化配置，否则不需要额外设置。

总结 #

最常见的问题就是没设置contentType、没加[FromBody]特性，或者前后端属性名称大小写不匹配。按照上面的步骤逐一排查，应该就能解决嵌套数组绑定失败的问题。

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