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 IEnumerablelistOrderDetailViewModel { get; set; } // ❌ 小写开头，不符合 C# 命名规范
应改为标准 PascalCase：
public IEnumerableListOrderDetailViewModel { get; set; } // ✅
同时，前端 JSON 中对应键名需匹配（默认 System.Text.Json 使用 camelCase 输出，但输入绑定默认区分大小写且按原名匹配）。为确保兼容，推荐：
-
统一使用 [JsonPropertyName("listOrderDetailViewModel")] 显式指定 JSON 键名（需引用 System.Text.Json.Serialization）：
public class OrderViewModel { // ... 其他属性 [JsonPropertyName("listOrderDetailViewModel")] public IEnumerableListOrderDetailViewModel { 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 及其嵌套集合完整、准确地绑定到服务端。
