Google Sheets HTML调用服务端函数超时及账号校验问题

挂起超时问题由三个核心问题导致，和用户校验逻辑的实现方式直接相关：

• 服务端调用了Browser.msgBox()：这个方法仅支持在Spreadsheet原生UI触发的执行上下文（比如手动点击自定义菜单、单元格编辑触发脚本）里使用，通过google.script.run从HTML页面异步调用服务端函数时，这个弹窗无法被渲染到前端页面，会直接阻塞服务端执行直到触发超时阈值。
• 服务端代码存在未定义变量错误：你已经把选中的agency作为参数传入emailAgency函数，但后续筛选数据时仍然在调用客户端才存在的selectedAgency变量，服务端环境下这个变量不存在，会直接抛出引用错误；同时recipient、subject、msg等变量仅在allTasks.length > 0的判断块内赋值，当没有匹配任务时，后续发邮件逻辑会直接因变量未定义中断。
• 校验逻辑可靠性不足：如果脚本是跨账号共享/使用消费者Gmail账号授权，Session.getActiveUser().getEmail()可能返回空字符串，导致校验逻辑误判。

• 移除服务端的Browser.msgBox()调用，把校验结果、执行结果通过返回值传回客户端，由前端负责弹窗提示
• 修复服务端的变量引用错误，统一使用传入的agency参数做筛选，补全边界逻辑（比如没有匹配任务时直接返回提示，不执行发邮件逻辑）
• 给google.script.run添加成功、失败回调，避免前端无响应
• （可选增强）如果需要更可靠的权限校验，在脚本部署时直接设置「只有指定账号可执行」，比代码内校验更稳定，不会出现拿不到用户邮箱的问题

客户端代码 #

function sendEmail() {
  if (confirm('Are you sure you want to send an email with the pending tasks?')) {
    const agency = selectedAgency();
    // 增加回调处理服务端返回结果
    google.script.run
      .withSuccessHandler(res => {
        alert(res);
      })
      .withFailureHandler(err => {
        alert('执行出错：' + err.message);
      })
      .emailAgency(agency);
  } else {
    return;
  }
}

服务端代码 #

function emailAgency(agency) {
  // 先做参数归一化，避免大小写、空格导致匹配失败
  const targetAgency = agency.toLowerCase().trim();
  const activeUser = Session.getActiveUser().getEmail().trim();
  // 校验不通过直接返回提示给前端，不再调用Browser.msgBox
  if (activeUser !== 'specific@domain.com') {
    return '请使用specific@domain.com账号登录后再执行自动化操作';
  }

  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const atSht = ss.getSheetByName('ABC');
  const atRng = atSht.getRange(1, 1, atSht.getLastRow(), atSht.getLastColumn());
  const atValues = atRng.getValues().filter(e => e[0] != '');

  // 替换原客户端变量selectedAgency为传入的参数targetAgency
  let allTasks = atValues.filter(e => e[1].toLowerCase() == targetAgency && e[4] === '' && e[10] === true);

  // 无匹配任务直接返回，终止后续执行
  if (allTasks.length === 0) {
    return '当前机构没有待跟进的任务，无需发送邮件';
  }

  const recipient = 'elon.musk@hotmail.com'
  let clients = allTasks.map(e => e[2]);
  clients = [...new Set(clients)];

  const subject = 'Some people need your attention'
  let msg = "<p>Hello,</p>" +
    "<p>These are the people you have to contact:</p>" +
    "<ul style='list-style-type:disc'>"
  clients.forEach(function(client) {
    msg += "<li>" + client + "</li> "
  });
  msg +=
    "</ul>" +
    "<p>Thanks.</p>" +
    "<p>Your team</p>"

  // 补全变量声明，移除未使用的冗余代码
  const sender = GmailApp.getAliases()[0] || Session.getEffectiveUser().getEmail();
  const name = 'Team ABC';
  GmailApp.sendEmail(recipient, subject, '', {
    from: sender,
    name: name,
    htmlBody: msg,
  });

  return '邮件发送成功';
}

如果调整后仍然出现拿不到activeUser邮箱的情况，说明当前脚本的授权上下文不允许获取访问者身份，这种情况不要强行在代码里做校验，直接在脚本部署时将执行权限设置为「只有我自己」，或者在共享表格时只给指定账号编辑权限，从入口层拦截未授权访问即可，不会再出现超时挂起的问题。

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