解决Google Apps Script意外中断时Sheet无法解锁的问题

1. 能否检测脚本中断并触发清理？ #

Google Apps Script 没有直接的全局中断钩子来捕获所有意外终止场景（如用户关闭标签、平台故障），但可以通过超时兜底+状态校验的组合方案间接处理这类情况。

2. 资源释放的最佳实践 #

针对你遇到的问题，推荐以下互补策略：

策略一：为锁定添加超时机制 #

修改锁定逻辑，记录锁定时间，配合定时触发器自动解锁超时的锁定：

function lockSheets() {
  const controlSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Control");
  // 存储锁定状态+时间戳
  controlSheet.getRange("A1").setValue("LOCKED");
  controlSheet.getRange("B1").setValue(new Date().getTime());
}

function unlockSheets() {
  const controlSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Control");
  controlSheet.getRange("A1:B1").clearContent();
}

// 定时检查并解锁超时锁定（示例设置15分钟超时）
function checkAndUnlockStaleLocks() {
  const controlSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Control");
  const lockStatus = controlSheet.getRange("A1").getValue();
  const lockTime = controlSheet.getRange("B1").getValue();
  
  if (lockStatus === "LOCKED" && lockTime) {
    const now = new Date().getTime();
    const timeoutMs = 15 * 60 * 1000;
    if (now - lockTime > timeoutMs) {
      unlockSheets();
      // 可选：记录超时解锁日志
      controlSheet.getRange("C1").setValue(`自动解锁：${new Date().toLocaleString()}`);
    }
  }
}

设置时间驱动触发器，让checkAndUnlockStaleLocks每5分钟运行一次，兜底处理超时未释放的锁定。

策略二：使用内置LockService替代单元格标记 #

Google官方的LockService专门用于处理并发执行，会在脚本终止（包括意外中断）时自动释放锁，无需手动兜底：

function myMacro() {
  const lock = LockService.getScriptLock();
  // 尝试获取锁，最多等待10秒，避免无限阻塞
  if (!lock.tryLock(10000)) {
    throw new Error("当前已有宏在执行，请稍后再试");
  }
  
  try {
    // 修改工作表的代码
  } catch (e) {
    console.error(e);
    SpreadsheetApp.getUi().alert(`执行出错：${e.message}`);
  } finally {
    // 手动释放锁更稳妥（内置锁也会自动释放）
    lock.releaseLock();
  }
}

注：LockService的锁针对脚本执行实例，适合防止同一脚本并发运行；跨脚本/多用户全局锁定可结合超时机制。

策略三：添加用户手动解锁入口 #

在工作表中添加“强制解锁”按钮，绑定解锁函数，让用户在锁定异常时手动重置：

function forceUnlockSheets() {
  // 可选：添加权限校验
  const allowedUsers = ["your-email@example.com"];
  if (!allowedUsers.includes(Session.getActiveUser().getEmail())) {
    SpreadsheetApp.getUi().alert("无权限执行此操作");
    return;
  }
  unlockSheets();
  SpreadsheetApp.getUi().alert("已强制解锁工作表");
}

操作步骤：在Google Sheets插入绘图/按钮，右键选择“分配脚本”绑定上述函数。

策略四：优化异常捕获范围 #

扩大try块覆盖范围，确保更多异常触发finally：

function myMacro() {
  let isLocked = false;
  try {
    lockSheets();
    isLocked = true;
    // 修改工作表的代码
  } catch (e) {
    console.error("已知异常：", e);
    SpreadsheetApp.getUi().alert(`执行出错：${e.message}`);
  } finally {
    if (isLocked) {
      unlockSheets();
    }
  }
}

针对不同中断场景的适配 #

• 平台/网络故障：依赖超时自动解锁+手动解锁入口
• 资源限制中断：提前用ScriptApp.getRemainingDailyQuota()监控资源，接近限制时主动释放锁，同时超时机制兜底
• 用户中断：内置LockService自动释放锁，单元格标记锁靠超时+手动解锁

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