使用getRange()时出现Range not found异常求助

问题描述 #

每次在程序第8行和第11行调用getRange()方法时，都会抛出「Exception: Range not found」异常，尝试使用getA1notation()和toString()方法后仍出现相同错误。相关代码如下：

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

function rangeAsNote(targCell, targRange) {
  //Sets up output string
  let rangeAsString = new String();
  //Creates new var "cell" and sets it to the inputted range of cells
  var cell = sheet.getRange(targCell);

  //Sets "rangeAsString" to "targRange" converted to the desired format using rangeToString()
  rangeAsString = rangeToString(sheet.getRange(targRange));

  //Sets the note of "cell" to "rangeAsString"
  cell.setNote(rangeAsString);

  return;
}

核心原因排查 #

• 参数格式不兼容：getRange()仅接受特定格式的参数（A1表示法字符串、合法行列号组合等），如果targCell或targRange的格式不符合要求（比如拼写错误的单元格地址、非字符串/数字类型参数），就会触发异常。
• 参数值超出范围：如果传入的单元格/区域行号大于工作表总行数、列号超出总列数，或者对应区域在当前工作表中不存在，也会抛出该异常。
• 参数传递异常：若targCell或targRange是经过其他逻辑处理后传入的值，可能在传递过程中被修改为无效格式，需要确认原始输入值的正确性。

解决步骤 #

1. 打印参数验证有效性
   在函数开头添加日志，输出targCell和targRange的实际值，确认格式和内容是否正确：

   console.log("targCell实际值:", targCell);
   console.log("targRange实际值:", targRange);
   

   同时确认参数类型：A1表示法需为正确格式的字符串（如"A1"、"B2:D5"），行列号需为≥1且不超过工作表最大行/列数的数字（可通过sheet.getMaxRows()、sheet.getMaxColumns()获取上限）。

2. 添加参数校验与异常捕获
   在函数中增加合法性检查，提前拦截无效输入，并捕获异常输出详细信息：

   function rangeAsNote(targCell, targRange) {
     let rangeAsString = "";
     // 校验参数格式
     if (!targCell || (typeof targCell !== 'string' && typeof targCell !== 'number')) {
       throw new Error("targCell参数无效，需为A1格式字符串或合法行列号");
     }
     if (!targRange || (typeof targRange !== 'string' && typeof targRange !== 'number')) {
       throw new Error("targRange参数无效，需为A1格式字符串或合法行列号");
     }
     try {
       var cell = sheet.getRange(targCell);
       rangeAsString = rangeToString(sheet.getRange(targRange));
       cell.setNote(rangeAsString);
     } catch (e) {
       console.error("执行错误:", e.message, "| 参数targCell:", targCell, "| 参数targRange:", targRange);
       throw e;
     }
   }
   

3. 确认工作表对象正确性
   验证sheet变量指向的是否为目标工作表，避免因索引错误导致后续操作失败：

   console.log("当前操作工作表名称:", sheet.getName());
   

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