如何在AppScript中实现函数排队？多用户WebApp并发场景需求

你当前用LockService加轮询sleep的方式之所以会出现顺序混乱，核心问题在于：固定时长的sleep无法保证请求的唤醒顺序，后发起的请求可能刚好在锁释放的瞬间抢到权限，反而先执行；而且45秒的sleep会快速消耗WebApp的执行时长，很容易触发超时限制。

要实现严格的FIFO（先进先出）执行，需要结合持久化队列和互斥锁：用持久化存储（比如Script Properties或表格）维护任务顺序，再通过锁保证只有一个实例在处理队列。

实现方案 #

1. 封装队列操作工具

用Script Properties存储任务队列，实现基本的队列增删操作：

// 任务队列工具类
const TaskQueue = {
  // 获取当前队列
  getQueue: function() {
    const props = PropertiesService.getScriptProperties();
    const queue = props.getProperty('taskQueue');
    return queue ? JSON.parse(queue) : [];
  },
  // 添加任务到队列末尾
  addTask: function(taskData) {
    const queue = this.getQueue();
    queue.push({
      id: Utilities.getUuid(),
      data: taskData,
      timestamp: new Date().getTime()
    });
    const props = PropertiesService.getScriptProperties();
    props.setProperty('taskQueue', JSON.stringify(queue));
  },
  // 移除并返回队首任务
  shiftTask: function() {
    const queue = this.getQueue();
    if (queue.length === 0) return null;
    const task = queue.shift();
    const props = PropertiesService.getScriptProperties();
    props.setProperty('taskQueue', JSON.stringify(queue));
    return task;
  }
};

2. 重写队列执行函数

修改你的queueScriptFunction，改成先入队再统一处理的逻辑：

/**
 * 按FIFO顺序执行任务，确保多用户请求依次处理
 * @param {Function} functionToCall 要执行的业务函数
 * @param {Array} args 业务函数的参数（可选）
 */
static queueScriptFunction(functionToCall, args = []) {
  // 1. 将任务序列化后加入队列（用函数名标识，确保全局可调用）
  const taskData = {
    funcName: functionToCall.name,
    args: args
  };
  TaskQueue.addTask(taskData);

  // 2. 获取脚本锁，确保只有一个实例处理队列
  const lock = LockService.getScriptLock();
  try {
    // 最长等待5分钟（WebApp默认最大执行时长为6分钟，留有余量）
    lock.waitLock(300000);
    
    // 3. 依次执行队列中的所有任务
    let task;
    while ((task = TaskQueue.shiftTask()) !== null) {
      try {
        // 根据函数名调用全局业务函数
        const targetFunc = global[task.data.funcName];
        if (typeof targetFunc === 'function') {
          targetFunc.apply(null, task.data.args);
          console.log(`任务 ${task.id} 执行完成`);
        } else {
          console.error(`找不到指定函数：${task.data.funcName}`);
        }
      } catch (error) {
        console.error(`任务 ${task.id} 执行失败:`, error);
        // 可选：失败任务可重新入队或记录到错误日志
      }
    }
  } catch (error) {
    console.error('获取锁超时，任务将留在队列等待后续处理:', error);
  } finally {
    // 无论成功失败，都释放锁
    if (lock.hasLock()) {
      lock.releaseLock();
    }
  }
}

关键注意事项 #

• 业务函数必须是全局可访问的，因为队列处理时需要通过函数名调用；如果函数在类中，需要把类实例挂载到全局，或者直接用全局函数
• 如果业务函数需要WebApp的请求上下文（比如e.parameter），要把必要的参数序列化后存入队列，不能直接传递对象
• Script Properties有存储大小限制（单属性最大9KB，总存储500KB），如果任务量或参数很大，建议改用Google Sheet存储队列
• 单个任务的执行时间尽量短，避免触发WebApp的执行超时；如果有大量任务，可搭配时间驱动触发器定期处理队列

原代码的问题总结 #

• 轮询sleep无法保证FIFO顺序：不同请求的sleep结束时间不确定，后发起的请求可能先抢到锁
• 45秒sleep会快速消耗执行时长，容易导致请求超时
• 没有持久化队列：如果某个请求崩溃或超时，未处理的任务会丢失

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