AJAX传CSV数据至PHP接口遇max_input_vars超限问题求解决

问题根源 #

你当前的AJAX请求把CSV解析后的数组以表单键值对的形式发送，jQuery会自动把数组展开成file[0]、file[1]、file[2]...这样的独立参数。当CSV行数/字段数较多时，参数数量会超过PHP的max_input_vars限制，触发报错。

解决方案：用JSON格式传递整个数组 #

我们可以把整个数组序列化为单个JSON字符串发送，这样请求只会包含一个请求体，不会占用多个input变量。

1. 修改前端AJAX代码

将数组转为JSON字符串，并设置正确的请求头，同时调整阻塞UI的时机（避免请求还没完成就解除阻塞）：

function pushToDatabase(lines){
    var array = lines;
    $.blockUI();
    $.ajax({
        url: "rest/v1/upload",
        method: "POST",
        dataType: "json",
        contentType: "application/json", // 关键：告诉后端请求体是JSON格式
        data: JSON.stringify(array), // 把数组序列化为单个JSON字符串
        success: function() {
            alert("Data has been uploaded succesfully.");
            $.unblockUI(); // 请求成功后再解除阻塞
        },
        error: function() {
            alert("Upload failed.");
            $.unblockUI(); // 请求失败也要解除阻塞
        }
    });
}

2. 修改后端FlightPHP端点代码

现在需要读取原始的JSON请求体，而不是从表单数据中获取参数：

Flight::route('POST /upload', function () {
    // 获取原始JSON请求体
    $jsonData = file_get_contents('php://input');
    // 解码为PHP数组（第二个参数true确保返回数组而非对象）
    $file = json_decode($jsonData, true);
    
    // 检查JSON解码是否成功
    if ($file === null) {
        Flight::json(['status' => 'error', 'message' => 'Invalid JSON data'], 400);
        return;
    }
    
    $status = Flight::pm()->upload_records($file);
    Flight::json($status);
});

为什么这样有效？ #

• 原来的表单编码方式（默认的application/x-www-form-urlencoded）会把数组拆分成大量独立的键值对，每个元素都算一个input变量，很容易触发max_input_vars限制。
• 改用JSON格式后，整个数组被打包成一个字符串，PHP只需要解析这一个请求体，不会消耗多个max_input_vars配额，完美绕过了参数数量限制的问题。

额外优化建议 #

• 可以在前端添加数组非空校验，避免发送空数据。
• 后端可以增加对接收数组的结构校验，确保数据符合upload_records函数的预期格式，避免后续处理出错。

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