从jQuery发送至Controller的对象列表始终为Null，求排查方案

我来帮你捋捋这个问题——从jQuery发对象列表到Controller总是收不到数据，这种情况我在项目里碰到过好多次，大概率是请求配置、数据格式或者模型绑定的细节没做好，咱们一步步排查：

1. 确保请求头与数据格式匹配 #

jQuery发送POST请求时，默认的content-type是application/x-www-form-urlencoded，但发送复杂对象列表必须用application/json，而且要把数据序列化为JSON字符串，否则后端无法正确解析。

错误示例（会导致绑定失败） #

$.post('/YourController/SaveQuestions', { questions: yourQuestionList }, function(res) {
  // 处理响应
});

正确示例 #

$.ajax({
  url: '/YourController/SaveQuestions',
  type: 'POST',
  contentType: 'application/json; charset=utf-8', // 必须指定这个头
  data: JSON.stringify(yourQuestionList), // 把列表转成JSON字符串
  success: function(res) {
    console.log('保存成功');
  },
  error: function(err) {
    console.error('请求失败', err);
  }
});

2. 检查Controller Action的参数绑定 #

要确保Action的参数能正确接收列表，有两种常见写法：

直接接收列表 #

[HttpPost]
public IActionResult SaveQuestions(List<Question> questions)
{
  // 先检查ModelState是否有效，排查绑定错误
  if (!ModelState.IsValid)
  {
    var errorMessages = ModelState.SelectMany(x => x.Value.Errors.Select(e => e.ErrorMessage));
    return BadRequest(string.Join("; ", errorMessages));
  }
  
  // 后续业务逻辑
  return Ok();
}

用ViewModel包装列表（更稳妥，适合复杂场景） #

如果直接传列表有问题，可以把列表包装在ViewModel里：

public class QuestionBatchViewModel
{
  public List<Question> Questions { get; set; }
}

// Action写法
[HttpPost]
public IActionResult SaveQuestions(QuestionBatchViewModel model)
{
  var questions = model.Questions;
  // 业务逻辑...
}

对应的jQuery请求要调整数据结构：

var requestData = { Questions: yourQuestionList };
$.ajax({
  // 其他配置不变
  data: JSON.stringify(requestData),
});

3. 前后端属性名必须完全匹配 #

检查前端对象的属性名和后端Question类的属性名大小写、拼写完全一致！比如前端写questionId（小写q），后端是QuestionId（大写Q），模型绑定就会失败，导致列表为null。

另外注意后端的CreatedDate属性：它是DateTime类型（非可空），如果前端没有传值，会导致ModelState验证失败，进而绑定失败。解决办法要么前端传一个有效值，要么把后端属性改成可空类型：

public DateTime? CreatedDate { get; set; }

4. 用浏览器工具检查实际请求数据 #

打开浏览器开发者工具（F12），切换到Network标签，找到发送的POST请求，查看Request Payload里的JSON结构：

• 有没有语法错误（比如多余的逗号）
• 属性名是否和后端模型完全匹配
• 列表是否正确包含多个对象

5. 排查ModelState验证失败 #

如果以上都没问题，就在Action里打印ModelState的错误信息，看看具体是哪个属性绑定失败：

if (!ModelState.IsValid)
{
  foreach (var key in ModelState.Keys)
  {
    var errors = ModelState[key].Errors;
    if (errors.Any())
    {
      Console.WriteLine($"属性 {key} 绑定错误：{string.Join(", ", errors.Select(e => e.ErrorMessage))}");
    }
  }
}

按照以上步骤排查，基本就能解决列表为null的问题啦！

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