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

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

发布时间 - 2026-01-02 00:00:00 点击率：次

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 及其嵌套集合完整、准确地绑定到服务端。

# javascript # java # jquery # html # js # 前端 # json # ajax # 编码 # 浏览器 # app # 工具 # 后端

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：如何使用 JavaFX 和 Gluon 开发并成功导出 An

下一篇：今日头条如何开通付费专栏今日头条开通付费专栏流程【指南】

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：如何使用 JavaFX 和 Gluon 开发并成功导出 An

下一篇：今日头条如何开通付费专栏今日头条开通付费专栏流程【指南】