ASP.NETCoreAJAX表单提交失败解决方法

各位小伙伴们，大家好呀！看看今天我又给各位带来了什么文章？本文标题是《ASP.NET Core AJAX 表单提交失败解决方法》，很明显是关于文章的文章哈哈哈，其中内容主要会涉及到等等，如果能帮到你，觉得很不错的话，欢迎各位多多点评和分享！

ASP.NET Core 中通过 AJAX 提交复杂 ViewModel 时，常因缺少反伪造令牌（AntiForgeryToken）、JSON 序列化配置不当或属性命名不匹配导致模型绑定失败，仅 DateTime 等默认值被绑定。本文详解修复步骤与最佳实践。

在 ASP.NET Core 中使用 AJAX 向 [HttpPost] Action 提交 JSON 数据时，若后端 OrderViewModel 仅绑定到 DateTime（如 OrderDate 的 get-only 属性），而其他字段（如 PaymentTypeId、CustomerId）均为默认值（0 或 null），说明模型绑定未成功——这通常由三大原因导致：缺少 Anti-Forgery Token 验证、JSON 序列化/反序列化不匹配，以及 C# 属性命名与 JavaScript 键名不一致。

✅ 正确解决方案（三步到位）

1. 前端：添加 Anti-Forgery Token 并注入 AJAX 请求头

ASP.NET Core 默认启用防伪验证（尤其在启用了 [AutoValidateAntiforgeryToken] 或全局过滤器时），AJAX POST 必须显式携带 __RequestVerificationToken。
在 .cshtml 视图顶部添加：

@Html.AntiForgeryToken()

然后在 JS 中提取并附加该 Token（推荐添加到请求头，更安全且符合 MVC Core 惯例）：

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

// 修改 AJAX 调用：
$.ajax({
    url: '/Home/Index',
    type: 'POST',
    contentType: 'application/json; charset=utf-8',
    headers: {
        "RequestVerificationToken": getAntiForgeryToken() // 注意：Key 名需与服务端策略匹配
    },
    data: JSON.stringify(objOrderViewModel),
    success: function (data) { alert("Success!"); },
    error: function (xhr) { 
        console.error("Error:", xhr.status, xhr.responseText); 
    }
});

⚠️ 注意：若服务端使用 ValidateAntiForgeryTokenAttribute 默认策略，它会从请求头中查找 RequestVerificationToken（而非表单数据）。若需从 data 中读取，请改用 headers: {} + data 合并方式（见下文备选方案）。

2. 后端：启用 JSON 模型绑定支持

ASP.NET Core 默认支持 application/json 绑定，但需确保控制器方法签名正确，并启用 JsonOptions 兼容性（尤其当属性名含驼峰/下划线时）：

// Startup.cs 或 Program.cs（.NET 6+）
builder.Services.Configure<JsonOptions>(options =>
{
    options.PropertyNamingPolicy = JsonNamingPolicy.CamelCase; // 若 JS 使用 camelCase（如 listOrderDetailViewModel → listOrderDetailViewModel）
    // 或注释此行，保持 PascalCase 一致性（推荐：JS 也用 PascalCase）
});

同时，修正 ViewModel 属性命名以匹配 JS 对象键：
当前 JS 中赋值为 objOrderViewModel.listOrderDetailViewModel，而 C# 属性名为 listOrderDetailViewModel（小写 l 开头），但 .NET 默认绑定区分大小写且要求 PascalCase。请统一为：

public class OrderViewModel
{
    public int OrderId { get; set; }
    public int PaymentTypeId { get; set; }
    public int CustomerId { get; set; }
    public string OrderNumber { get; set; }
    public DateTime OrderDate => DateTime.Now; // get-only 属性不会被绑定，但可保留
    public decimal FinalTotal { get; set; }
    // ✅ 关键修改：改为 PascalCase，与 JS 键名一致（或启用 CamelCase 策略）
    public IEnumerable<OrderDetailViewModel> ListOrderDetailViewModel { get; set; } 
}

对应 JS 中也同步更新：

objOrderViewModel.ListOrderDetailViewModel = ListOrderDetailViewModel; // 注意首字母大写

3. （可选）简化调试：临时禁用防伪验证（仅开发环境）

若需快速验证是否为 Token 问题，可在控制器上临时添加 [IgnoreAntiforgeryToken]（切勿用于生产！）：

[HttpPost]
[IgnoreAntiforgeryToken]
public JsonResult Index(OrderViewModel objOrderViewModel)
{
    // 断点检查 objOrderViewModel 是否完整填充
    return Json(new { success = true, data = objOrderViewModel });
}

✅ 完整可运行示例（精简版）

JS（含 Token + PascalCase）：

function submitOrder() {
    const model = {
        PaymentTypeId: parseInt($("#PaymentType").val()) || 0,
        CustomerId: parseInt($("#Customer").val()) || 0,
        FinalTotal: parseFloat($("#txtFinalTotal").val()) || 0,
        ListOrderDetailViewModel: []
    };

    $("#tblRestaurantItemList tbody tr").each(function () {
        const $row = $(this);
        model.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
        });
    });

    $.ajax({
        url: '/Home/Index',
        type: 'POST',
        contentType: 'application/json; charset=utf-8',
        headers: { "RequestVerificationToken": $('input[name="__RequestVerificationToken"]').val() },
        data: JSON.stringify(model),
        success: res => alert('Submitted!'),
        error: xhr => alert('Error: ' + xhr.status)
    });
}

Controller（增强健壮性）：

[HttpPost]
public IActionResult Index([FromBody] OrderViewModel model)
{
    if (!ModelState.IsValid)
        return BadRequest(ModelState);

    // 处理业务逻辑...
    return Json(new { success = true, message = "Order saved." });
}

? 总结

• ✅ 必做：视图中 @Html.AntiForgeryToken() + AJAX 请求头携带 RequestVerificationToken
• ✅ 必做：JS 对象键名与 C# 属性名严格一致（推荐 PascalCase），或全局配置 JsonNamingPolicy
• ✅ 推荐：使用 [FromBody] 显式声明绑定源，避免隐式混淆
• ❌ 避免：contentType: 'application/json' 却将 Token 放入 data（易被忽略）；get-only 属性无法绑定输入值

遵循以上步骤，OrderViewModel 将完整绑定，不再仅剩 DateTime.Now。

理论要掌握，实操不能落！以上关于《ASP.NETCoreAJAX表单提交失败解决方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！