ASP.NET 8控制器无法接收Ajax传递的JSON数据问题排查

核心问题分析 #

你遇到的ViewModel属性全为null的问题，核心原因是ASP.NET默认不会自动从JSON请求体绑定模型，需要显式声明；同时需确保模型类的结构符合绑定要求。

修复步骤 #

1. 给控制器参数添加[FromBody]特性 #

发送JSON格式的POST请求时，必须通过[FromBody]告诉ASP.NET从请求体中读取并绑定数据，否则框架会默认尝试从表单数据绑定，导致绑定失败。

修改后的控制器代码：

[Authorize]
[HttpPost("/UserPanel/Checkout")]
public IActionResult Checkout([FromBody] CheckOutViewModel checkOutViewModel)
{
    // 新增：检查模型绑定是否有效，方便调试错误
    if (!ModelState.IsValid)
    {
        var errors = ModelState.Values.SelectMany(v => v.Errors.Select(e => e.ErrorMessage));
        return BadRequest(new { success = false, message = "无效数据", errors = errors });
    }

    bool isCheckoutSuccessful = true;

    if (isCheckoutSuccessful)
    {
        return Json(new { success = true, message = "结账完成" });
    }
    else
    {
        return Json(new { success = false, message = "结账失败" });
    }
}

2. 确保嵌套模型类符合绑定要求 #

检查CartAddressViewModel和CartDeliveryAndPaymentDetails类，必须满足：

• 拥有无参构造函数（默认不写构造函数时编译器会自动生成）
• 所有需要绑定的属性都有get和set访问器

示例正确的嵌套类定义：

public class CartAddressViewModel
{
    public string Address { get; set; }
    public string State { get; set; }
    public string District { get; set; }
    public string ZipCode { get; set; }
}

public class CartDeliveryAndPaymentDetails
{
    public string DeliveryDate { get; set; }
    public string DeliveryTime { get; set; }
    public string Details { get; set; }
    public string PaymentMethod { get; set; }
}

3. 验证属性名映射（可选） #

ASP.NET默认支持驼峰（前端）到帕斯卡命名（后端）的自动映射，前提是你的项目配置了JSON序列化选项（通常在Program.cs中）：

builder.Services.AddControllers()
    .AddJsonOptions(options => 
    {
        options.JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
    });

你的前端代码中tax、totalPrice等驼峰命名的属性，会自动映射到后端Tax、TotalPrice等帕斯卡命名的属性，无需额外修改。

4. 调试建议 #

如果绑定仍有问题，可通过以下方式排查：

• 查看浏览器开发者工具的网络请求，确认请求体的JSON格式正确
• 在控制器中打印ModelState的错误信息，定位具体绑定失败的属性

内容的提问来源于stack exchange，提问作者maryam forex