Google Sheets插件Alert未被操作时的超时错误处理问询

我之前也碰到过这个问题，确实挺头疼的——Apps Script的原生UI对话框（像SpreadsheetApp.getUi().alert(...)这类）有个硬编码的5分钟超时限制：当用户超过5分钟没对弹窗做任何操作（切标签页、离开电脑都算），服务器端会自动抛出“Timed out”异常，而且浏览器端的弹窗不会同步关闭，用户返回后操作的话，后续逻辑大概率会因为之前的异常出现混乱。

为什么会这样？ #

原生UI对话框的交互是基于服务器端的会话控制的，一旦超过5分钟无响应，服务器就会判定会话失效，抛出异常，但客户端的弹窗属于浏览器本地元素，没法实时同步服务器的超时状态，所以就出现了“异常已抛出但弹窗还在”的矛盾情况。

可行的解决方案 #

1. 改用HtmlService自定义弹窗（推荐）

如果需要更长的交互时间，或者想更灵活地控制超时逻辑，最好用HtmlService创建模态对话框（Modal Dialog），配合客户端JavaScript来处理超时：

• 可以在HTML弹窗里添加定时器，监听用户无操作状态，超时后自动关闭弹窗并通知服务器端
• 完全避免服务器端的强制超时异常

示例代码：
服务器端脚本

function showCustomDialog() {
  const html = HtmlService.createHtmlOutputFromFile('CustomDialog')
    .setWidth(300)
    .setHeight(200);
  SpreadsheetApp.getUi().showModalDialog(html, '请完成操作');
}

// 供客户端调用的超时处理函数
function handleTimeout() {
  // 这里可以做超时后的逻辑处理，比如记录日志、标记状态
  SpreadsheetApp.getActiveSpreadsheet().toast('操作超时，请重新发起', '提示', 5);
}

CustomDialog.html

<!DOCTYPE html>
<html>
  <body>
    <p>请在10分钟内完成操作</p>
    <button onclick="google.script.host.close()">关闭</button>

    <script>
      // 设置10分钟超时（可自定义时长）
      const timeoutMinutes = 10;
      let timeoutTimer = setTimeout(() => {
        google.script.run.handleTimeout();
        google.script.host.close();
      }, timeoutMinutes * 60 * 1000);

      // 监听用户操作，重置超时定时器
      document.addEventListener('mousemove', resetTimer);
      document.addEventListener('keydown', resetTimer);

      function resetTimer() {
        clearTimeout(timeoutTimer);
        timeoutTimer = setTimeout(() => {
          google.script.run.handleTimeout();
          google.script.host.close();
        }, timeoutMinutes * 60 * 1000);
      }
    </script>
  </body>
</html>

2. 捕获超时异常（针对必须用原生弹窗的场景）

如果一定要用原生的alert/confirm，可以在代码里用try-catch块捕获超时异常，避免后续逻辑崩溃：

function showNativeAlert() {
  const ui = SpreadsheetApp.getUi();
  try {
    const response = ui.alert('请选择操作', '请在5分钟内完成选择', ui.ButtonSet.YES_NO);
    
    if (response === ui.Button.YES) {
      // 用户选择YES的业务逻辑
      ui.alert('你选择了YES');
    } else {
      // 用户选择NO的业务逻辑
      ui.alert('你选择了NO');
    }
  } catch (e) {
    // 判断是否为超时异常
    if (e.message.includes('Timed out')) {
      // 处理超时情况：提示用户、记录状态等
      SpreadsheetApp.getActiveSpreadsheet().toast('操作超时，请重新尝试', '提示', 5);
    } else {
      // 其他异常直接抛出
      throw e;
    }
  }
}

3. 提前告知用户时间限制

在原生弹窗的提示文本里明确告知用户“请在5分钟内完成操作，否则将超时”，让用户有预期，减少不必要的困惑。

注意事项 #

• 原生UI对话框的5分钟超时是服务器端的硬限制，无法通过配置延长，所以如果需要更长交互时间，必须用HtmlService方案
• 即使是HtmlService弹窗，也要注意Apps脚本的总执行时间限制（目前是6分钟/执行），如果有长时间运行的逻辑，建议用异步处理（比如google.script.run.withSuccessHandler()）

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