如何通过命名JSON属性向C#控制器传复杂对象？Web API赋值异常求助

这个问题我之前也碰到过，核心原因就是JSON的结构和你C#端接收的类结构不匹配，导致模型绑定无法正确映射属性值。咱们一步步来拆解问题和解决方案：

问题分析 #

你提到两种情况：

• 直接传递innerData时，myClass能正常填充 → 说明innerData的结构和MyComplexClass的属性是完全匹配的
• 把innerData作为myData的属性传入时，myClass所有属性为null → 这是因为你当前的API控制器方法是直接接收MyComplexClass类型的参数，但发送的JSON是一个嵌套结构（外层有myData属性），模型绑定找不到对应的映射关系

举个具体的例子，假设你现在的代码是这样的：

当前C#代码 #

// 你的复杂类
public class MyComplexClass
{
    public string Name { get; set; }
    public int Age { get; set; }
}

// API控制器方法
[HttpPost]
public IHttpActionResult SubmitData(MyComplexClass myClass)
{
    // 这里myClass的属性全为null
    return Ok();
}

当前JS AJAX代码 #

var innerData = { Name: "John", Age: 30 };
var myData = { myData: innerData }; // 嵌套了一层

$.ajax({
    url: "/api/YourController/SubmitData",
    type: "POST",
    contentType: "application/json",
    data: JSON.stringify(myData),
    success: function(res) { /* 处理逻辑 */ }
});

这种情况下，发送的JSON结构是{ "myData": { "Name": "John", "Age": 30 } }，但控制器期望接收的是{ "Name": "John", "Age": 30 }，自然无法绑定，所以属性全为null。

两种解决方案 #

方案1：创建包装类匹配JSON结构 #

在C#端创建一个包装类，用来接收嵌套的JSON结构：

// 新增包装类
public class MyDataWrapper
{
    // 属性名要和JS里的myData完全一致（注意大小写，Web API默认支持驼峰转帕斯卡，但最好保持一致避免问题）
    public MyComplexClass myData { get; set; }
}

// 修改控制器方法参数
[HttpPost]
public IHttpActionResult SubmitData(MyDataWrapper wrapper)
{
    // 现在wrapper.myData的属性就能正常填充了
    var targetClass = wrapper.myData;
    return Ok(targetClass);
}

方案2：调整JS的JSON结构（无需修改C#代码） #

如果不想新增包装类，直接把innerData作为请求体发送，也就是你已经验证过能正常工作的方式：

var innerData = { Name: "John", Age: 30 };

$.ajax({
    url: "/api/YourController/SubmitData",
    type: "POST",
    contentType: "application/json",
    data: JSON.stringify(innerData), // 直接传递innerData，不嵌套
    success: function(res) { /* 处理逻辑 */ }
});

额外注意事项 #

• 确保AJAX请求的contentType设置为"application/json"，这是Web API正确解析JSON请求体的前提，如果遗漏这个设置，模型绑定会尝试用表单格式解析，导致失败。
• 如果JS里的属性名和C#类的属性名大小写不一致（比如JS用驼峰name，C#用帕斯卡Name），Web API的默认JSON格式化器会自动处理大小写映射，不需要额外配置；但如果是完全不同的名字，需要用[JsonProperty]特性指定映射：

  public class MyComplexClass
  {
      [JsonProperty("userName")] // 指定对应JS里的userName属性
      public string Name { get; set; }
  }
  

内容的提问来源于stack exchange，提问作者Luke T Brooks