使用Google Apps Script编辑Google Sheet时无法捕获受保护单元格编辑错误，如何实现错误捕获与编辑权限验证？

我明白你的困扰——这个权限错误确实有点特殊，普通的try-catch根本抓不到它。原因是：当脚本尝试编辑受保护区域时，触发的是Google Apps Script的硬权限终止错误（属于AuthorizationException的子类），这类错误会直接中断脚本执行，不会进入catch代码块。

下面给你两种解决方案，优先推荐第一种提前验证权限的方式，更高效也更符合最佳实践：

1. 提前验证编辑权限（推荐方案） #

在尝试编辑单元格之前，先检查目标区域是否受保护，以及当前运行脚本的用户是否有编辑权限。这样可以避免触发无法捕获的错误，还能提前给出友好提示。

这里给你写了完整的测试代码，包含权限检查的辅助函数：

function myFunction() {
  var ss = SpreadsheetApp.openByUrl("https://docs.google.com/spreadsheets/d/1TCSNpk4zUhoHo_fUDYbr-jtXCI8U1lWJlhqwNP9C5V4/edit#gid=0");
  var backendsheet = ss.getSheetByName("MasterData");
  var targetRange = backendsheet.getRange(2,2);

  // 先检查是否有编辑权限
  if (checkEditPermission(ss, targetRange)) {
    try {
      targetRange.setValue("ABC");
      Logger.log("✅ 编辑成功");
    } catch(err) {
      Logger.log("⚠️ 编辑时出现意外错误: " + err.message);
    }
  } else {
    Logger.log("❌ 无权限编辑该受保护区域，请联系表格所有者");
  }
}

// 辅助函数：检查目标范围是否允许当前用户编辑
function checkEditPermission(spreadsheet, targetRange) {
  var currentUser = Session.getEffectiveUser().getEmail();
  // 检查所有区域级保护
  var rangeProtections = spreadsheet.getProtections(SpreadsheetApp.ProtectionType.RANGE);
  
  for (var i = 0; i < rangeProtections.length; i++) {
    var protection = rangeProtections[i];
    var protectedRange = protection.getRange();
    
    // 判断目标单元格是否在受保护区域内
    if (isRangeOverlapping(targetRange, protectedRange)) {
      // canEdit()会直接返回当前用户是否有权限编辑该保护区域
      if (!protection.canEdit()) {
        return false;
      }
    }
  }
  
  // 额外检查工作表级别的保护（如果整个表被保护了）
  var sheetProtection = targetRange.getSheet().getProtections(SpreadsheetApp.ProtectionType.SHEET)[0];
  if (sheetProtection && !sheetProtection.canEdit()) {
    return false;
  }
  
  return true;
}

// 辅助函数：判断两个单元格/区域是否重叠
function isRangeOverlapping(range1, range2) {
  var r1 = {
    top: range1.getRow(),
    bottom: range1.getLastRow(),
    left: range1.getColumn(),
    right: range1.getLastColumn()
  };
  var r2 = {
    top: range2.getRow(),
    bottom: range2.getLastRow(),
    left: range2.getColumn(),
    right: range2.getLastColumn()
  };
  
  // 反向判断：如果两个范围完全不重叠，返回false；否则返回true
  return !(r1.bottom < r2.top || r1.top > r2.bottom || r1.right < r2.left || r1.left > r2.right);
}

关键说明： #

• protection.canEdit()是核心方法：它会自动判断当前用户是否在保护规则的授权列表中，或者是否是表格所有者，无需手动遍历授权用户列表。
• 同时检查区域级和工作表级保护：避免遗漏整个工作表被保护的情况。

2. 用Sheets API捕获错误（备选方案） #

如果你一定要在编辑操作后捕获这个错误，可以使用Google Sheets API来执行编辑操作——API调用的异常是可以被try-catch捕获的。不过需要先启用Sheets API：

1. 在脚本编辑器中，点击资源 > 高级Google服务
2. 找到Google Sheets API，开启它，然后点击确定

然后用下面的代码测试：

function editWithSheetsAPI() {
  const spreadsheetId = "1TCSNpk4zUhoHo_fUDYbr-jtXCI8U1lWJlhqwNP9C5V4";
  const targetRange = "MasterData!B2";
  const valueToSet = "ABC";
  
  try {
    Sheets.Spreadsheets.Values.update(
      { values: [[valueToSet]] },
      spreadsheetId,
      targetRange,
      { valueInputOption: "USER_ENTERED" }
    );
    Logger.log("✅ 编辑成功");
  } catch(err) {
    if (err.message.includes("protected cell")) {
      Logger.log("❌ 捕获到权限错误: 无法编辑受保护单元格");
    } else {
      Logger.log("⚠️ 其他错误: " + err.message);
    }
  }
}

关键说明： #

• Sheets API的错误会以HTTP异常的形式抛出，所以try-catch可以正常捕获。
• 这种方式适合必须执行编辑操作后处理错误的场景，但效率不如提前检查权限。

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