谷歌表格文件审批工作流脚本报错：TypeError: Cannot read properties of undefined (reading 'range')

报错根源 #

TypeError: Cannot read properties of undefined (reading 'range') 是因为手动运行宏时没有传入事件对象e，或是触发器配置错误导致e未被正确初始化。onEdit作为简单触发器，只有用户手动编辑表格时才会自动传入e；如果直接点击运行宏，e为undefined，自然无法读取e.range。

修复步骤 #

1. 完善脚本的健壮性 #

给函数加上严谨的校验逻辑，避免e为空时崩溃，同时优化API调用次数：

function onChange(e) {
  // 校验事件对象及range是否存在
  if (!e || !e.range) return;
  
  const sheet = e.range.getSheet();
  const row = e.range.getRow();
  // 跳过表头行（如果表头在第1行）
  if (row === 1) return;

  // 一次性获取B、C、D列的复选框状态
  const [checkboxB, checkboxC, checkboxD] = sheet.getRange(row, 2, 1, 3).getValues()[0];
  
  if (checkboxB && checkboxC && checkboxD) {
    const fileLink = sheet.getRange(row, 1).getValue();
    const folderId = 'THIS_IS_THE_FOLDER_ID'; 
    
    try {
      const file = DriveApp.getFileByUrl(fileLink);
      // 移除文件原父文件夹
      const parents = file.getParents();
      if (parents.hasNext()) {
        parents.next().removeFile(file);
      }
      // 添加到目标文件夹
      DriveApp.getFolderById(folderId).addFile(file);
      Logger.log(`文件 ${file.getName()} 已移动到文件夹 ${folderId}`);
    } catch (err) {
      Logger.log(`处理失败：${err.message}`);
    }
  }
}

function onEdit(e) {
  onChange(e);
}

2. 正确触发脚本 #

• 不要手动运行宏：onEdit是自动触发器，当你手动勾选B/C/D列的复选框时，会自动触发脚本执行，无需手动点击运行。
• 批量处理历史已审批行：如果需要处理表格中已完成三审的历史行，单独写一个批量处理函数（不依赖事件对象）：

function batchProcessApprovedFiles() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const data = sheet.getDataRange().getValues();
  const folderId = 'THIS_IS_THE_FOLDER_ID'; 

  // 从第2行开始遍历（跳过表头）
  for (let i = 1; i < data.length; i++) {
    const rowNum = i + 1;
    const [fileLink, checkboxB, checkboxC, checkboxD] = data[i];
    
    if (checkboxB && checkboxC && checkboxD) {
      try {
        const file = DriveApp.getFileByUrl(fileLink);
        const parents = file.getParents();
        if (parents.hasNext()) {
          parents.next().removeFile(file);
        }
        DriveApp.getFolderById(folderId).addFile(file);
        Logger.log(`第${rowNum}行：文件 ${file.getName()} 已移动`);
      } catch (err) {
        Logger.log(`第${rowNum}行处理失败：${err.message}`);
      }
    }
  }
}

运行这个批量函数时，按提示完成权限授权即可。

3. 权限与链接注意事项 #

• 确保当前账号对目标文件有编辑权限（移动文件需要编辑权限）。
• A列的文件链接必须是可直接访问的Google Drive文件链接，不能是共享文件夹链接或无效链接。

内容的提问来源于stack exchange，提问作者o.ionut