Ajax POST到WebAPI Core接收数据始终为null问题求助

我之前也碰到过几乎一模一样的问题，折腾了好一阵子才找到根源，给你几个排查和解决的方向：

• 务必把JS对象序列化为JSON字符串
  很多人容易忽略这关键一步：直接把JS对象传给data属性是不行的，必须用JSON.stringify()把它转成标准的JSON格式字符串。比如你的Ajax代码应该写成这样：

  $.ajax({
    url: '/api/YourController/YourAction',
    type: 'POST',
    contentType: 'application/json; charset=utf-8',
    data: JSON.stringify(yourComplexObject), // 核心：这里一定要序列化
    success: function(response) {
      // 处理返回结果
    }
  });
  

  如果不做序列化，浏览器会默认把数据转成表单格式，WebAPI的模型绑定器根本无法识别嵌套的children数组结构。

• 检查WebAPI端的模型类定义
  服务器对应的模型类必须满足几个绑定要求：

  • children属性的类型要和前端数组结构匹配，比如前端是对象数组，服务器端要定义成public List<ChildModel> Children { get; set; }
  • 主模型类和子模型类都要有无参构造函数（如果没写自定义构造函数，C#会默认生成；但如果写了带参构造函数，一定要手动补上无参的）
  • 所有需要绑定的属性都要有公共的getter和setter，否则模型绑定器无法给属性赋值

• 给Action参数加上[FromBody]特性
  在WebAPI的Action方法里，接收对象的参数必须标记[FromBody]，明确告诉框架从请求体里读取JSON数据：

  public IHttpActionResult YourAction([FromBody] YourComplexModel obj)
  {
    // 业务逻辑处理
    return Ok();
  }
  

  这是最容易漏掉的点，不加的话框架会尝试从URL参数里绑定数据，自然拿不到嵌套的复杂对象。

• 验证请求的Payload格式是否正确
  打开浏览器开发者工具（F12），切换到Network标签，找到你的Ajax请求，查看Request Payload部分：

  • 确认children数组是正确的结构，比如"children": [{"id": 1, "name": "test"}, ...]
  • 检查有没有JSON语法错误，比如多余的逗号、未闭合的引号，这些都会直接导致模型绑定失败

• 确保请求方法用POST
  尽量用POST传递复杂对象，GET方法的参数是通过URL传递的，嵌套数组结构很难被正确解析，WebAPI对GET的复杂对象绑定支持非常有限，优先用POST更稳妥。

如果以上步骤都检查过还是有问题，可以把你的JS对象结构、服务器端模型类代码贴出来，这样能更快定位问题。

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