Google Apps Script编辑器调用函数时参数为null报错排查

问题背景 #

开发环境基于Google Apps Script，全局已定义playgroundSheet工作表对象，存在两种执行表现：

• 硬编码单元格范围时执行正常：在testDates函数内直接为getRange方法传入固定参数'BH2'、'BL2'，读取两个单元格的日期值转换为毫秒时间戳计算日期间隔，执行结果符合预期，日志可正常输出对应日期、时间戳、间隔天数4.0。
• 传参调用时触发异常：将单元格范围设为形参定义testDates(DateLow, DateHigh)函数，通过代码var numberOfDays = testDates('BH2','BL2')调用时，抛出异常：

Exception: Argument cannot be null: a1Notation
报错行为第13行var now = playgroundSheet.getRange(DateLow).getValue();，提示形参DateLow为null。已尝试传入(行号,列号,行数,列数)格式参数仍无法解决。

根因定位 #

问题出在函数触发方式上：Google Apps Script编辑器的运行逻辑是，你在顶部运行菜单选中哪个函数，就会直接无参执行哪个函数，不会自动读取代码中其他位置写的带参调用语句传入参数。
你虽然在代码里写了var numberOfDays = testDates('BH2','BL2')，但如果直接选中testDates作为运行入口，这行调用代码根本不会被执行，testDates接收到的DateLow、DateHigh参数都是undefined，传入getRange时就会被判定为null抛出对应异常。
如果是将该函数作为表格自定义函数在单元格中使用，出现该报错则是因为单元格公式中未传入对应参数，比如写成了=testDates()。

修复方案 #

• 调试运行时不要直接选中带形参的testDates函数执行，新增一个无参的入口调试函数，在函数内部写带参数的调用逻辑，运行时选中这个入口函数即可：

// 原有日期间隔计算函数
function testDates(DateLow, DateHigh) {
  var now = playgroundSheet.getRange(DateLow).getValue();
  var targetDate = playgroundSheet.getRange(DateHigh).getValue();
  var dayGap = (targetDate.getTime() - now.getTime()) / (1000 * 60 * 60 * 24);
  Logger.log(now, now.getTime(), targetDate, targetDate.getTime(), dayGap);
  return dayGap;
}

// 调试专用入口函数，运行时选中该函数执行
function debugTestDates() {
  var numberOfDays = testDates('BH2', 'BL2');
  Logger.log('计算得到间隔天数：' + numberOfDays);
}

• 如果是作为单元格自定义函数使用，检查公式写法，必须将两个范围字符串作为参数传入，正确写法为=testDates("BH2","BL2")。
• 可以在函数开头增加参数非空校验，提前拦截无参调用场景，抛出明确的业务提示：

function testDates(DateLow, DateHigh) {
  if (!DateLow || !DateHigh) {
    throw new Error('需传入DateLow、DateHigh两个A1格式单元格范围参数');
  }
  // 原有计算逻辑
}

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