Google Apps Script中SpreadsheetApp.insertRowsAfter方法参数不匹配错误排查

这个错误的核心原因很明确：你调用CREATEROW函数时，rowNum参数根本没传进去，导致它的值是null——而insertRowsAfter方法的第一个参数要求是有效的正整数行号，null显然不符合它的签名要求，所以直接报错了。

你说移除insertRowsAfter调用后参数能被正确识别，其实是个错觉：这时候即使rowNum是null或者undefined，因为你没用到它，所以不会触发方法的参数校验，看起来好像参数没问题，但实际上参数还是没正确传递。

给你几个具体的解决办法： #

• 脚本编辑器手动测试时传参：在脚本编辑器顶部选择CREATEROW函数后，点击运行按钮旁边的下拉箭头，选择"运行函数"，在弹出的对话框里输入具体的整数行号（比如5），再执行，这时候参数就能正确传入了。
• 给参数加默认值（适合按钮/菜单触发）：如果是通过表格里的自定义按钮、菜单或者简单触发器调用函数，默认是不会传递参数的，这时候可以给rowNum加个默认值，比如用当前选中的行号：

  function CREATEROW(rowNum) {
    // 如果没传入参数，默认用当前活动单元格的行号
    rowNum = rowNum || SpreadsheetApp.getActiveRange().getRow();
    var ss = SpreadsheetApp.getActiveSpreadsheet();
    var sheet = ss.getActiveSheet();
    sheet.insertRowsAfter(rowNum, 1);
  }
  

• 添加参数校验避免错误：为了防止后续再出现类似的参数问题，可以在函数开头加个校验逻辑，确保传入的是有效整数：

  function CREATEROW(rowNum) {
    // 校验参数是否为有效正整数
    if (typeof rowNum !== 'number' || !Number.isInteger(rowNum) || rowNum < 1) {
      throw new Error("请传入有效的正整数行号哦");
    }
    var ss = SpreadsheetApp.getActiveSpreadsheet();
    var sheet = ss.getActiveSheet();
    sheet.insertRowsAfter(rowNum, 1);
  }
  

本质上就是要保证insertRowsAfter的第一个参数是一个合法的、大于等于1的整数，只要解决了参数传递的问题，这个错误就会消失啦。

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