使用jQuery将View数据传递到Controller时参数为空的问题排查

以下是常见问题点及修复方案：

1. 确保AJAX请求的内容类型与数据序列化正确 #

传递复杂对象数组时，必须指定contentType为application/json，并将数据序列化为JSON字符串，否则MVC模型绑定无法解析：

$.ajax({
    url: '/YourController/InsertCustomers',
    type: 'POST',
    contentType: 'application/json; charset=utf-8',
    data: JSON.stringify(customersArray),
    success: function(res) { /* 处理逻辑 */ },
    error: function(xhr) { /* 错误处理 */ }
});

2. 检查Controller参数的特性与定义 #

必须为列表参数添加[FromBody]特性，明确告知框架从请求体中读取JSON数据：

[HttpPost]
public IActionResult InsertCustomers([FromBody] List<Customer> customers)
{
    // 业务逻辑
    return Ok();
}

同时确保Controller的请求方法标记为[HttpPost]，与AJAX的type: "POST"对应。

3. 验证实体类与前端字段的匹配度 #

• Customer实体类的属性必须是public且包含get/set访问器：

  public class Customer
  {
      public string Name { get; set; }
      public string Email { get; set; }
      // 其他属性需保持与前端字段一致
  }
  

• 前端构建的客户对象属性名必须与实体类完全一致（大小写敏感），比如实体类是Name，前端不能写成name或CustomerName。

4. 确认前端构建的数组结构正确 #

在AJAX提交前，通过console.log(customersArray)打印数组，确保结构符合预期：

// 正确的数组结构示例
[
    { Name: "张三", Email: "zhangsan@test.com" },
    { Name: "李四", Email: "lisi@test.com" }
]

避免出现属性缺失、嵌套错误或拼写错误。

5. 处理混合数据场景（如同时上传文件） #

如果表单中包含文件上传，不能使用JSON序列化，需改用FormData传递数据，此时Controller参数需调整为接收IFormFile和客户数据（可将客户数据序列为JSON字符串存入FormData）：

var formData = new FormData();
formData.append('customers', JSON.stringify(customersArray));
formData.append('file', $('#fileInput')[0].files[0]);

$.ajax({
    url: '/YourController/InsertCustomers',
    type: 'POST',
    contentType: false,
    processData: false,
    data: formData,
    // ...
});

Controller对应处理：

[HttpPost]
public IActionResult InsertCustomers(string customers, IFormFile file)
{
    var customerList = JsonConvert.DeserializeObject<List<Customer>>(customers);
    // 业务逻辑
    return Ok();
}

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