Google Sheets脚本报错：参数不匹配SpreadsheetApp.Sheet.getRange方法签名

错误根源 #

报错Exception: The parameters (null,number,number,number) don't match the method signature for SpreadsheetApp.Sheet.getRange的核心问题是SubmitData02里的freeRow没被赋值：

• 当Trades工作表的I列（从I2到最后一行）没有空单元格时，遍历columnI的循环找不到符合columnI[i] == ""的项，freeRow一直是初始的undefined，传入getRange后被识别成null，导致参数不符合方法要求。
• 第一个脚本能正常运行，只是因为H列刚好有空单元格，freeRow被成功赋值了。

修复方法 #

方案1：处理无空行的情况，默认追加到最后一行 #

修改SubmitData02的循环逻辑，遍历完所有行都没找到空单元格时，把freeRow设为工作表的下一行，同时修正原脚本的行号计算错误：

function SubmitData02() {
  var ss        = SpreadsheetApp.getActiveSpreadsheet();
  var formSS    = ss.getSheetByName("Input"); 
  var datasheet = ss.getSheetByName("Trades");
  var freeRow;
  var columnI = datasheet.getRange("I2:I" + datasheet.getLastRow()).getDisplayValues().flat();
  
  // 遍历查找空行，修正行号计算：从I2开始，i=0对应行号2，所以是i+2
  for(var i = 0; i < columnI.length; i++){
    if(columnI[i] == "") {
      freeRow = i + 2;
      break;
    }
  }
  
  // 没找到空行就追加到最后一行
  if (!freeRow) {
    freeRow = datasheet.getLastRow() + 1;
  }
  
  var values = [[formSS.getRange("I6").getValue()]];
  
  datasheet.getRange(freeRow, 9, 1, 1).setValues(values);
  
  formSS.getRange('C6:F6').clearContent();
}

方案2：优化空行查找逻辑（更高效） #

用getNextDataCell方法直接定位空行，避免遍历所有单元格，同时处理无空行的情况：

function SubmitData02() {
  var ss        = SpreadsheetApp.getActiveSpreadsheet();
  var formSS    = ss.getSheetByName("Input"); 
  var datasheet = ss.getSheetByName("Trades");
  
  // 从I2开始向下找第一个空单元格
  var startRange = datasheet.getRange("I2");
  var nextDataCell = startRange.getNextDataCell(SpreadsheetApp.Direction.DOWN);
  var freeRow;
  
  if (nextDataCell.getRow() === datasheet.getLastRow()) {
    // 最后一行有数据，就追加到下一行
    freeRow = datasheet.getLastRow() + 1;
  } else {
    // 找到空行的行号
    freeRow = nextDataCell.getRow() + 1;
  }
  
  var values = [[formSS.getRange("I6").getValue()]];
  
  datasheet.getRange(freeRow, 9, 1, 1).setValues(values);
  
  formSS.getRange('C6:F6').clearContent();
}

额外提示 #

第一个脚本SubmitData01里的freeRow = i + 1同样存在行号计算错误，应该改成freeRow = i + 2，否则会把数据写到H1而不是H2开始的空行，建议同步修正。

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