多人查看共享Google表格时SpreadsheetApp.getLastRow()抛出异常

问题概述 #

我们有一款运行多年的Google Apps Script，用于清理供教师查看的共享放学管理Google表格。此前多用户查看时脚本正常运行，但约1个月前开始，只要有其他用户查看表格，脚本就失效，抛出错误：

Exception: Service Spreadsheets failed while accessing document with id 18y1U3...

• 错误触发点：调用ws.getLastRow()、sheet.getLastRow()或sheet.getLastColumn()时
• 临时现象：复制工作表后异常消失1天，但次日复发
• 触发条件：仅当有其他用户查看工作簿时出现，无用户查看时正常

解决思路与方案 #

1. 添加文档锁避免并发冲突 #

多用户协作时，读写操作的并发冲突是这类问题的常见原因。在脚本关键逻辑前添加锁，确保同一时间只有一个实例执行：

function cleanSheet() {
  const lock = LockService.getDocumentLock();
  // 等待30秒获取锁，超时则终止执行
  if (!lock.tryLock(30000)) {
    console.log("无法获取执行锁，脚本退出");
    return;
  }
  try {
    // 核心清理逻辑
    const ss = SpreadsheetApp.getActiveSpreadsheet();
    const ws = ss.getSheetByName("目标工作表");
    const lastRow = ws.getLastRow();
    // ...后续清理代码
  } catch (e) {
    console.error("脚本执行错误：", e);
  } finally {
    lock.releaseLock(); // 必须释放锁，避免死锁
  }
}

2. 改用内存计算替代实时表格查询 #

避免频繁调用getLastRow()这类需要实时访问表格服务的方法，一次性读取所有数据后在内存中计算有效行/列：

function cleanSheet() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const ws = ss.getSheetByName("目标工作表");
  // 一次性读取全部数据到内存
  const data = ws.getDataRange().getValues();
  
  // 计算有效最后一行（过滤末尾空行）
  let lastRow = data.length;
  while (lastRow > 0 && data[lastRow - 1].every(cell => cell === "")) {
    lastRow--;
  }
  
  // 计算有效最后一列（过滤末尾空列）
  let lastCol = data[0] ? data[0].length : 0;
  while (lastCol > 0 && data.every(row => row[lastCol - 1] === "")) {
    lastCol--;
  }
  
  // ...后续清理逻辑
}

3. 检查表格协作设置 #

• 确认所有教师的权限为仅查看，避免意外编辑操作导致表格状态异常
• 关闭「建议编辑」模式，该模式会增加并发冲突的概率

4. 排查表格本身的异常 #

• 检查表格是否存在损坏单元格、异常合并单元格或格式问题，这类问题在多用户访问时可能触发服务错误
• 创建全新表格，手动复制数据（不要直接复制工作表），重新部署脚本后观察是否恢复正常

5. 确认脚本运行环境 #

确保脚本使用最新的Chrome V8运行时：

1. 打开Apps Script编辑器
2. 点击「运行」→「部署」→「测试部署」
3. 在设置中确认运行时为「Chrome V8」

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