使用Google Apps Script提交表单数据至数据表时遇列数不匹配错误

错误核心原因 #

你遇到的列数不匹配错误，源于两个关键问题：

1. 数据数组列数不统一：原代码中，表头行和请求信息行是4列，而items数组的每一行是3列，导致整个待写入的二维数组各行列数不一致。
2. Range范围计算错误：你硬指定了Range的行数为5、列数为items[0].length +3（即6列），但实际数据的列数和行数都与这个范围不匹配。

另外原代码的逻辑也不规范——请求信息单独占一行，后续item行不带请求标识，会导致数据表的记录关联性断裂。

修正后的代码 #

以下是修复并优化后的代码，每个item都会关联请求的三个核心信息，作为数据表的完整一行记录：

function submitRequest() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var formSS = ss.getSheetByName("req_form");
  var datasheet = ss.getSheetByName("data");
  
  // 获取表单核心请求信息
  var requestNumber = formSS.getRange("C4").getValue();
  var dateNeeded = formSS.getRange("C5").getValue();
  var dateRequested = formSS.getRange("C6").getValue();
  
  // 一次性读取所有item行的数据，减少API调用次数
  var itemRange = formSS.getRange("E3:G32");
  var itemValues = itemRange.getValues();
  
  // 构造待写入的数据数组
  var outputData = [];
  // 添加表头（如果data表已存在表头，可删除此行）
  outputData.push(["Request Number", "Date Needed", "Date Requested", "Item Detail 1", "Item Detail 2", "Item Detail 3"]);
  
  // 遍历处理每个item
  for (var i = 0; i < itemValues.length; i++) {
    var val1 = itemValues[i][0];
    var val2 = itemValues[i][1];
    var val3 = itemValues[i][2];
    
    // 只要item有一个字段不为空，就添加为一条记录
    if (val1 || val2 || val3) {
      outputData.push([requestNumber, dateNeeded, dateRequested, val1, val2, val3]);
    }
  }
  
  // 校验是否有有效数据
  if (outputData.length === 1) {
    SpreadsheetApp.getUi().alert('请填写至少一个项目！');
    return;
  }
  
  // 动态计算写入范围
  var lastRow = datasheet.getLastRow();
  var targetRange = datasheet.getRange(lastRow + 1, 1, outputData.length, outputData[0].length);
  targetRange.setValues(outputData);
  
  // 清空表单输入
  formSS.getRange("C4:C6").clearContent();
  formSS.getRange("E3:G32").clearContent();
  
  SpreadsheetApp.getUi().alert('请求已提交！');
}

关键优化点 #

1. 统一列数：所有记录行（包括表头）都固定为6列，完全匹配Range的列数，解决了核心报错问题。
2. 数据关联性：每个item行都携带请求编号、日期等核心信息，保证数据表记录的完整性和可追溯性。
3. 效率提升：一次性读取所有item区域的数据，避免循环调用getRange，降低API调用次数，符合Apps Script的最佳实践。

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