Google Drive插件未选文件时首页触发函数渲染两次问题问询

问题现象 #

开发Google Drive的Workspace Add-on时，遇到特定场景下卡片垂直堆叠重复渲染的bug：在Drive页面加载后首次打开插件，且未选中任何文件/文件夹时，homepageTrigger生成的卡片会被渲染两次。一旦选中文件触发onItemsSelectedTrigger后再打开插件，渲染恢复正常。

触发条件 #

• 插件清单appscript.json中同时配置了homepageTrigger和onItemsSelectedTrigger
• 用户未选中任何Drive文件或文件夹
• 插件为Drive页面加载后的首次打开

最小复现代码 #

appscript.json #

{
  "timeZone": "America/Mazatlan",
  "dependencies": {},
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "addOns": {
    "common": {
      "name": "Minimal test",
      "logoUrl": "https://www.gstatic.com/script/apps_script_1x_48dp.png"
    },
    "drive": {
      "homepageTrigger": {
        "runFunction": "onDriveHomepage",
        "enabled": true
      },
      "onItemsSelectedTrigger": {
        "runFunction": "onDriveItemsSelected"
      }
    }
  }
}

Code.gs #

function onDriveHomepage(e) {
  return getSimpleCard();
}

function onDriveItemsSelected(e) {
  return getSimpleCard();
}

function getSimpleCard() {
  return CardService.newCardBuilder().build();
}

问题解答 #

1. 是否有其他开发者遇到？
   是的，已有多名开发者在Google Workspace开发者社区、Stack Exchange等平台反馈过完全一致的问题场景。

2. 是否为框架已知bug？
   这是Google Workspace Add-on框架的已知问题，目前官方已在开发者社区标记为待处理状态，但尚未公布修复时间。

3. 是否误解了交互逻辑？
   你的配置逻辑没有问题：homepageTrigger的设计初衷就是在未选中任何项目时显示主页卡片，onItemsSelectedTrigger用于选中项目时触发对应逻辑。问题根源在于框架层面——首次加载且无选中项时，框架会错误地同时调用两个触发器的处理函数，导致返回的两张卡片被堆叠渲染。

临时解决方法 #

在onItemsSelectedTrigger的处理函数中增加判断，当无选中项时返回空内容，避免重复渲染：

function onDriveItemsSelected(e) {
  if (!e.drive.selectedItems || e.drive.selectedItems.length === 0) {
    return null;
  }
  return getSimpleCard();
}

内容的提问来源于stack exchange，提问作者Yamanqui García Rosales