AJAX POST大JSON对象数组至控制器返回NULL，无法生成Excel

别急，我帮你捋捋这个问题——单个JSON对象能正常接收，换成数组/List就返回null，大概率是请求格式或者参数绑定的细节没处理对，咱们一步步排查解决：

这是最容易踩的坑！后端接收List类型的JSON数组时，必须明确告诉框架要从请求体里解析数据，不然默认会去URL参数里找，自然拿不到值。示例代码：

[HttpPost]
public IActionResult GenerateExcel([FromBody] List<ClientBookingInfo> bookings)
{
    // 你的Excel生成逻辑
}

如果是老版本的ASP.NET MVC（非Core），同样要加这个特性，同时确保项目引用了System.Web.Mvc。

前端AJAX必须满足两个核心要求：

• 把Content-Type设为application/json，告诉后端接收的是JSON格式数据
• 把JS数组序列化成JSON字符串再传递，不能直接传原数组（否则jQuery会自动转成form-data格式，后端无法解析）

示例AJAX代码：

// 假设你的预生成数据是bookingsData数组
$("#exportBtn").click(function() {
    $.ajax({
        url: "/YourController/GenerateExcel",
        type: "POST",
        contentType: "application/json; charset=utf-8", // 必须设置
        data: JSON.stringify(bookingsData), // 一定要序列化数组
        success: function(result) {
            // 处理返回的Excel文件（比如下载）
        },
        error: function(xhr) {
            console.error("请求失败：", xhr.responseText);
        }
    });
});

前端数组里的每个对象，字段名必须和后端ClientBookingInfo类的属性名对应（ASP.NET Core默认大小写不敏感，但老版本或特殊配置下可能敏感）。

比如后端类是这样：

public class ClientBookingInfo
{
    public int Id { get; set; }
    public string ClientName { get; set; }
    public DateTime BookingDate { get; set; }
}

前端数组就要对应写成：

var bookingsData = [
    { Id: 1, ClientName: "张三", BookingDate: "2024-05-20T10:00:00" },
    { Id: 2, ClientName: "李四", BookingDate: "2024-05-21T14:30:00" }
];

如果字段名不匹配（比如前端写client_name，后端是ClientName），会导致绑定失败，甚至整个List返回null。

打开浏览器开发者工具（F12），切换到Network标签，找到这个POST请求，查看Request Payload：

• 正常情况应该是标准的JSON数组格式，比如：

[
    {"Id":1,"ClientName":"张三","BookingDate":"2024-05-20T10:00:00"},
    {"Id":2,"ClientName":"李四","BookingDate":"2024-05-21T14:30:00"}
]

• 如果Payload是form-data格式（比如bookings[0].Id=1&...），那肯定是前端AJAX没序列化数组导致的，回到第二步修正即可。

如果你用的是ASP.NET Core 3.0+，默认使用System.Text.Json序列化，若需要处理日期格式、枚举或大小写问题，可以在Program.cs里配置：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.PropertyNameCaseInsensitive = true; // 开启大小写不敏感
        options.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter()); // 处理枚举
        options.JsonSerializerOptions.DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull; // 忽略null值
    });

如果项目依赖Newtonsoft.Json（Json.NET），要确保已添加服务配置：

builder.Services.AddControllers()
    .AddNewtonsoftJson(options =>
    {
        options.SerializerSettings.ContractResolver = new CamelCasePropertyNamesContractResolver();
        options.SerializerSettings.DateFormatString = "yyyy-MM-ddTHH:mm:ss";
    });

最常见的问题就是没加[FromBody]或者AJAX没序列化数组/没设置Content-Type，先把这两个点检查修正，大概率就能解决参数为null的问题。

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