如何为Google Sheets脚本设置单实例运行，阻止重复执行？

嗨，针对你这个共享Google Sheets里脚本重复执行的问题，我有几个实用的方案，其中结合try/catch/finally来处理是完全可行的——这也是确保脚本状态能正确清理的关键，下面一步步给你拆解：

核心思路 #

我们可以用Google Apps Script的PropertiesService来存储一个「运行标记」：

1. 脚本启动时先检查这个标记，如果标记存在（说明已有实例在跑），就弹出提示并退出。
2. 如果标记不存在，就设置标记，然后执行你的核心业务逻辑。
3. 不管脚本是成功完成还是中途报错，都要强制清除标记——这一步就靠finally块来保证，完美解决异常情况下标记残留的问题。

方案1：全局锁（所有用户共享，同一时间仅一个实例运行） #

如果想确保整个共享文档里，不管哪个同事点击按钮，都只能有一个脚本实例在跑，用脚本级别的属性存储：

function runMainScript() {
  // 获取脚本全局属性存储，所有用户共享这个状态
  const scriptProps = PropertiesService.getScriptProperties();
  const runningFlagKey = "IS_SCRIPT_RUNNING";
  
  // 检查是否已有运行中的实例
  if (scriptProps.getProperty(runningFlagKey) === "true") {
    SpreadsheetApp.getUi().alert("脚本正在运行中，请稍等片刻再尝试！");
    return;
  }
  
  try {
    // 设置运行标记，锁定脚本
    scriptProps.setProperty(runningFlagKey, "true");
    
    // 👇这里放你的核心业务代码
    copyPasteBaseData();       // 复制粘贴基础数据
    generateSheetAsPDF();      // 生成工作表PDF
    sendEmailWithPDF();        // 发送带附件的邮件
    
  } catch (error) {
    // 捕获异常，给用户友好提示
    SpreadsheetApp.getUi().alert(`脚本执行出错啦：${error.message}`);
    throw error; // 可选：如果需要在脚本编辑器的日志里记录错误，保留这行
  } finally {
    // 无论成功还是失败，都强制清除运行标记
    scriptProps.deleteProperty(runningFlagKey);
  }
}

方案2：用户级锁（仅限制当前用户重复点击） #

如果只是想防止同一个同事不小心连续点击按钮（不影响其他用户的执行），把getScriptProperties()换成getUserProperties()即可，这样每个用户的运行状态是独立的：

// 替换属性获取方式
const userProps = PropertiesService.getUserProperties();
// 后续的检查、设置、删除都用userProps

额外优化：超时保护 #

Google Apps Script的脚本有6分钟的运行超时限制，如果脚本因为超时被强制终止，finally块可能不会执行，导致标记残留。我们可以加个时间戳判断，自动清理超时的无效标记：

function runMainScript() {
  const scriptProps = PropertiesService.getScriptProperties();
  const runningFlagKey = "IS_SCRIPT_RUNNING";
  const timestampKey = "RUN_TIMESTAMP";
  
  const now = new Date().getTime();
  const lastRunTime = Number(scriptProps.getProperty(timestampKey) || 0);
  const timeoutLimit = 7 * 60 * 1000; // 设置7分钟超时（比官方限制多1分钟冗余）
  
  // 检查：要么正在运行且未超时，才拒绝执行
  const isRunning = scriptProps.getProperty(runningFlagKey) === "true";
  const isTimeout = (now - lastRunTime) > timeoutLimit;
  
  if (isRunning && !isTimeout) {
    SpreadsheetApp.getUi().alert("脚本正在运行中，请稍等片刻再尝试！");
    return;
  }
  
  try {
    // 更新运行标记和时间戳
    scriptProps.setProperty(runningFlagKey, "true");
    scriptProps.setProperty(timestampKey, now.toString());
    
    // 核心业务代码...
    copyPasteBaseData();
    generateSheetAsPDF();
    sendEmailWithPDF();
    
  } catch (error) {
    SpreadsheetApp.getUi().alert(`脚本执行出错：${error.message}`);
    throw error;
  } finally {
    // 清理标记和时间戳
    scriptProps.deleteProperty(runningFlagKey);
    scriptProps.deleteProperty(timestampKey);
  }
}

关于try/catch的作用 #

完全可以用try/catch来实现状态的可靠管理：

• try块负责执行核心逻辑，同时设置运行标记。
• catch块捕获异常，给用户反馈，避免脚本默默崩溃。
• finally块是重中之重——不管脚本成功还是失败，都会执行这里的代码，确保运行标记被清除，不会出现“脚本卡死导致后续无法启动”的情况。

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