Ajax传参至ASP.NET Core控制器：含非空Modalites的实体变为null

这个问题我之前也碰到过，核心原因是ASP.NET Core的模型绑定对嵌套集合的格式有严格要求——当你用默认的表单序列化或者格式不正确的JSON提交时，只要集合（比如你的Modalites）有元素，模型绑定就无法正确解析整个对象，导致参数全为null。下面给你两种可靠的解决方案，根据你的提交方式选就行：

方案一：用JSON格式提交（推荐，更稳定） #

这是处理嵌套集合最不容易出错的方式，步骤如下：

1. 构建正确的JSON数据对象 #

在前端手动组装包含Modalites集合的JSON结构，确保每个集合元素的属性都正确映射：

// 先收集基础属性
var proprieteData = {
    Libelle: $("#Libelle").val(),
    Rang: parseInt($("#Rang").val()),
    // 注意TypePropriete如果是枚举，要传对应的值（整数或枚举名称字符串）
    TypePropriete: parseInt($("#TypePropriete").val()),
    Dependance: $("#Dependance").val(),
    Modalites: [] // 初始化集合数组
};

// 遍历页面上的Modalites元素，逐个添加到数组
$(".modalite-item").each(function(index) {
    var modalite = {
        // 替换成ChoixPropriete的实际属性
        ChoixProprieteId: parseInt($(this).find(".choix-id").val()),
        Libelle: $(this).find(".choix-libelle").val()
    };
    proprieteData.Modalites.push(modalite);
});

2. 发送Ajax请求（指定JSON contentType） #

一定要设置contentType: "application/json; charset=utf-8"，告诉服务器我们提交的是JSON数据：

$.ajax({
    url: "/ProprieteBienFinance/Update", // 替换成你的控制器Action路径
    type: "POST",
    contentType: "application/json; charset=utf-8",
    data: JSON.stringify(proprieteData),
    success: function(response) {
        // 处理成功逻辑，比如刷新列表
        console.log("更新成功");
    },
    error: function(xhr) {
        console.error("提交失败：", xhr.responseText);
    }
});

3. 修正控制器Action（添加[FromBody]特性） #

在Action参数上加上[FromBody]，让模型绑定从请求体中读取JSON数据：

[HttpPost]
public IActionResult Update([FromBody] ProprieteBienFinance model)
{
    // 先检查模型绑定是否有效
    if (!ModelState.IsValid)
    {
        // 输出绑定错误，方便调试
        var errors = ModelState.Values.SelectMany(v => v.Errors.Select(e => e.ErrorMessage));
        return BadRequest(string.Join("; ", errors));
    }

    // 这里写你的更新逻辑
    _context.Update(model);
    await _context.SaveChangesAsync();

    return Ok();
}

方案二：用表单序列化提交（适合传统表单场景） #

如果坚持用表单序列化，必须确保集合元素的name属性符合索引化格式，让模型绑定能识别：

1. 在CSHTML中正确生成集合元素的name #

循环生成Modalites元素时，用索引来命名：

@model ProprieteBienFinance

<form id="proprieteForm">
    <!-- 基础属性输入框 -->
    <input type="text" id="Libelle" name="Libelle" value="@Model.Libelle" />
    <input type="number" id="Rang" name="Rang" value="@Model.Rang" />
    <!-- ...其他属性 -->

    <!-- Modalites集合元素 -->
    @for (int i = 0; i < Model.Modalites.Count; i++)
    {
        <div class="modalite-item">
            <input type="hidden" name="Modalites[@i].ChoixProprieteId" value="@Model.Modalites[i].ChoixProprieteId" />
            <input type="text" name="Modalites[@i].Libelle" value="@Model.Modalites[i].Libelle" />
        </div>
    }

    <button type="button" id="submitBtn">提交</button>
</form>

2. 发送Ajax请求（用表单序列化） #

直接序列化整个表单，不需要手动构建对象：

$("#submitBtn").click(function() {
    $.ajax({
        url: "/ProprieteBienFinance/Update",
        type: "POST",
        data: $("#proprieteForm").serialize(),
        success: function(response) {
            console.log("更新成功");
        },
        error: function(xhr) {
            console.error("提交失败：", xhr.responseText);
        }
    });
});

3. 控制器Action（无需[FromBody]） #

这种方式是表单格式提交，所以不需要[FromBody]：

[HttpPost]
public IActionResult Update(ProprieteBienFinance model)
{
    if (!ModelState.IsValid)
    {
        var errors = ModelState.Values.SelectMany(v => v.Errors.Select(e => e.ErrorMessage));
        return BadRequest(string.Join("; ", errors));
    }

    // 更新逻辑
    _context.Update(model);
    await _context.SaveChangesAsync();

    return Ok();
}

额外调试技巧 #

如果还是有问题，先检查ModelState.IsValid，如果是false，输出错误信息就能知道哪个属性绑定失败了。另外，确保ChoixPropriete类有无参构造函数，模型绑定需要这个才能实例化对象。

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