You need to enable JavaScript to run this app. 如何将Ajax传入的JSON字符串正确映射到ASP.NET MVC C#控制器的自定义类参数
优惠活动
大模型
产品
解决方案
定价
更多

如何将Ajax传入的JSON字符串正确映射到ASP.NET MVC C#控制器的自定义类参数

问题根因
  • 前后端的JSON结构与后端类定义完全错位,是导致空引用的核心原因:
    • 前端实际发送的JSON根节点结构为{"ItemList": [商品对象1, 商品对象2...]},也就是根层的键名是ItemList,对应的值是商品数组。
    • 你定义的ItemList类,实际匹配的JSON结构是{"Items": [商品数组]}——类的属性名是Items,但前端传的JSON里根本没有Items这个键,只有ItemList。
    • 模型绑定阶段因为找不到匹配的属性值,所以list.Items默认是null,调用.Count()自然会抛ArgumentNullException。
  • 之前把参数类型改成object能拿到数据,只是因为框架没有做强类型结构校验,直接返回了原始的反序列化对象,并没有完成结构化映射。
可落地的修复方案

方案1:调整后端类结构(改动最小,推荐)

直接把ItemList类里的属性名改成和前端JSON键完全一致,不需要改动前端代码:

public class ItemList
{
  // 原属性名Items改为和JSON键匹配的ItemList
  public List<Item> ItemList { get; set; }
}

修改后原控制器代码即可正常运行,遍历、计数都不会出现空引用:

[HttpPost]
public JsonResult Order([FromBody] ItemList list)
{
    var response = new
    {
        Success = true,
        Message = "Item Added Succesfully",
        Data = list.ItemList.Count()
    };
    return Json(response);
}

注意:ASP.NET默认的JSON序列化/反序列化是大小写不敏感的,前端JSON里小写字段id/name/price/count,可以自动匹配类里大写开头的Id/Name/Price/Count属性,不需要额外配置。

方案2:调整前端传参结构(适配现有后端类)

如果不想改动后端的类定义,就把前端构造请求数据的代码调整为和后端类结构一致:
原来的构造代码:

// 原写法:根节点键为ItemList
var myData = {ItemList: JSON.parse(sessionStorage.getItem('shoppingCart'))};

修改为:

// 改成根节点键为Items,和后端ItemList类的属性名匹配
var myData = {Items: JSON.parse(sessionStorage.getItem('shoppingCart'))};

调整后请求发送的JSON结构就和ItemList类完全匹配,不会再出现Items为null的问题。

方案3:显式配置JSON映射(前后端都不改结构)

如果前后端的传参/类结构都不想动,就给类属性加显式映射特性,告诉框架哪个JSON键要对应哪个类属性:

// 引入Newtonsoft.Json命名空间(ASP.NET MVC默认使用的序列化库)
public class ItemList
{
  // 显式指定要映射JSON中名为ItemList的键
  [JsonProperty("ItemList")]
  public List<Item> Items { get; set; }
}

配置完成后原控制器代码不需要任何修改,即可正常完成绑定。

关键避坑提示:ASP.NET的模型绑定逻辑是匹配类的属性名,不匹配类名。哪怕你类名叫ItemList,只要类内部的属性名和JSON的键对不上,就永远无法完成正确映射,不要混淆类名和JSON键的对应关系。


内容的提问来源于stack exchange,提问作者Salim

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 20:06:02