ASP.NET Core AJAX 表单提交中模型绑定失败的常见原因与解决方案

asp.net core 中通过 ajax 提交 json 数据时，若控制器接收的 viewmodel 仅部分属性（如 datetime）有值而其他字段为空，通常是因缺少反伪造令牌、content-type 不匹配或模型绑定命名不一致所致。本文详解完整修复方案。

在 ASP.NET Core 中使用 AJAX 向 [HttpPost] 接口提交复杂对象（如嵌套集合的 OrderViewModel）时，模型绑定失败是一个高频问题。根据您提供的代码，objOrderViewModel 在控制器中几乎为空（仅 OrderDate 因只读属性自动计算而存在），根本原因在于以下三点协同作用：

✅ 1. 必须包含 Anti-Forgery Token（反伪造令牌）

ASP.NET Core 默认启用防跨站请求伪造（CSRF）保护。若控制器或全局配置启用了 [AutoValidateAntiforgeryToken]（如在 Startup.cs 或 Program.cs 中调用 AddControllersWithViews().AddAntiforgery() 并配合 RequireAntiforgeryToken 策略），所有 POST 请求必须携带有效的 __RequestVerificationToken。AJAX 请求无法自动附带该令牌（不像表单提交），需手动注入。

修复步骤：

• 在 .cshtml 视图顶部添加：

  @Html.AntiForgeryToken()

  这会生成类似 的隐藏字段。

• 在 JavaScript 中提取并随请求发送：

  function getAntiForgeryToken() {
      const token = document.querySelector('input[name="__RequestVerificationToken"]');
      return token ? token.value : '';
  }

• 修改 AJAX 配置，在 data 中显式传入该令牌（注意：必须作为顶层属性，且名称严格为 __RequestVerificationToken）：

  const payload = {
      ...objOrderViewModel,
      __RequestVerificationToken: getAntiForgeryToken()
  };
  
  $.ajax({
      url: '/Home/Index',
      type: 'POST',
      contentType: 'application/json; charset=utf-8',
      data: JSON.stringify(payload), // ⚠️ 注意：此时 data 是字符串化后的 JSON
      dataType: 'json',
      success: function (data) { alert('Success!'); },
      error: function (xhr) { 
          console.error('Error:', xhr.status, xhr.responseText); 
      }
  });

✅ 2. 确保 Content-Type 与数据格式严格匹配

您的 contentType: 'application/json; charset=utf-8' 是正确的，但必须确保 data 是 JSON 字符串（而非 JS 对象）。否则 ASP.NET Core 模型绑定器无法解析。您当前代码中 JSON.stringify(objOrderViewModel) 已正确，但若后续混用（如误将对象直接传入 data），会导致绑定失败。

✅ 正确：

data: JSON.stringify({ PaymentTypeId: 1, CustomerId: 5, FinalTotal: 99.99 })

❌ 错误（会被当作表单编码处理，忽略 contentType）：

data: { PaymentTypeId: 1, CustomerId: 5 } // ❌ jQuery 会序列化为 query string

✅ 3. 检查模型属性命名与 JSON 键名一致性

ASP.NET Core 默认使用 PascalCase → camelCase 映射（通过 System.Text.Json）。但您的前端使用 listOrderDetailViewModel（camelCase），而后端属性为 listOrderDetailViewModel（PascalCase？注意：C# 属性名应为 ListOrderDetailViewModel 更规范）。

⚠️ 当前模型存在关键隐患：

public IEnumerable listOrderDetailViewModel { get; set; } // ❌ 小写开头，不符合 C# 命名规范

应改为标准 PascalCase：

public IEnumerable ListOrderDetailViewModel { get; set; } // ✅

同时，前端 JSON 中对应键名需匹配（默认 System.Text.Json 使用 camelCase 输出，但输入绑定默认区分大小写且按原名匹配）。为确保兼容，推荐：

• 统一使用 [JsonPropertyName("listOrderDetailViewModel")] 显式指定 JSON 键名（需引用 System.Text.Json.Serialization）：

  public class OrderViewModel
  {
      // ... 其他属性
      [JsonPropertyName("listOrderDetailViewModel")]
      public IEnumerable ListOrderDetailViewModel { get; set; }
  }

• 或在 Program.cs 中全局配置 JSON 命名策略（推荐）：

  builder.Services.Configure(options => 
      options.PropertyNamingPolicy = JsonNamingPolicy.CamelCase);

  此时前端可保持 listOrderDetailViewModel，后端属性名也建议同步改为 ListOrderDetailViewModel（逻辑更清晰）。

✅ 完整修正后的 AJAX 调用示例

function submitOrder() {
    const objOrderViewModel = {
        PaymentTypeId: parseInt($("#PaymentType").val()) || 0,
        CustomerId: parseInt($("#Customer").val()) || 0,
        FinalTotal: parseFloat($("#txtFinalTotal").val()) || 0,
        listOrderDetailViewModel: [] // ✅ 与后端 [JsonPropertyName] 一致
    };

    $("#tblRestaurantItemList").find("tr:gt(0)").each(function () {
        const $row = $(this);
        objOrderViewModel.listOrderDetailViewModel.push({
            ItemId: parseInt($row.find("td:eq(0)").text()) || 0,
            Quantity: parseFloat($row.find("td:eq(3)").text()) || 0,
            Total: parseFloat($row.find("td:eq(5)").text()) || 0,
            Discount: parseFloat($row.find("td:eq(4)").text()) || 0,
            UnitPrice: parseFloat($row.find("td:eq(2)").text()) || 0
        });
    });

    const payload = {
        ...objOrderViewModel,
        __RequestVerificationToken: $('input[name="__RequestVerificationToken"]').val()
    };

    $.ajax({
        url: '/Home/Index',
        type: 'POST',
        contentType: 'application/json; charset=utf-8',
        data: JSON.stringify(payload),
        dataType: 'json',
        success: function (response) {
            alert('Order submitted successfully!');
            ResetItems();
            ResetItemsDetails();
        },
        error: function (xhr) {
            alert(`Error: ${xhr.status} - ${xhr.responseText}`);
        }
    });
}

? 验证与调试建议

• 在浏览器开发者工具中检查 Network → Payload，确认发送的 JSON 结构与后端模型完全匹配（包括键名、类型、嵌套层级）。
• 在控制器中临时添加日志：

  [HttpPost]
  public JsonResult Index(OrderViewModel objOrderViewModel)
  {
      // 断点查看 objOrderViewModel 是否有值，或打印日志
      Console.WriteLine($"Received: PaymentType={objOrderViewModel.PaymentTypeId}, Count={objOrderViewModel.ListOrderDetailViewModel?.Count()}");
      return Json(new { success = true });
  }

• 若仍失败，尝试在 Startup.cs/Program.cs 中临时禁用防伪验证（仅开发环境）以隔离问题：

  services.AddControllersWithViews(options => 
      options.Filters.Add(new IgnoreAntiforgeryTokenAttribute()));

遵循以上三步（令牌 + JSON 格式 + 命名映射），即可彻底解决 ASP.NET Core AJAX 提交中模型绑定为空的问题，确保 OrderViewModel 及其嵌套集合完整、准确地绑定到服务端。