Google Workspace Add-on安装后菜单不显示,AuthMode.NONE问题排查
可能导致Google Workspace Add-on菜单不显示的原因
- 隐性的AuthMode.NONE服务调用:即便移除了全局服务调用,
onOpen内部嵌套函数、引用的其他脚本文件中可能存在未被发现的授权服务调用(如PropertiesService、GmailApp)。本地模拟测试因账号已有授权未触发报错,但审核环境完全无授权,会直接阻断菜单加载。 - appsscript.json配置错误:独立项目需正确配置
oauthScopes和addOns字段,尤其是common节点下的homepageTrigger、onOpenTrigger需关联到你的函数。配置缺失或错误会导致系统无法触发onOpen/onInstall。 - 部署版本不一致:提交审核的部署版本可能未包含最新修改(移除全局调用、
onInstall调用onOpen的逻辑),需确认审核版本与本地测试版本一致。 - 账号环境差异:审核可能使用Workspace企业账号测试,个人Gmail账号下正常的逻辑,在企业账号的权限限制(如管理员禁用Add-on权限)下可能失效。
- 未捕获的执行错误:本地日志未覆盖审核环境的执行上下文,可在
onOpen中添加try-catch块捕获错误:function onOpen(e) { try { // 菜单生成逻辑示例 SpreadsheetApp.getUi().createMenu('邮件合并') .addItem('开始合并', 'startMerge') .addToUi(); } catch (err) { console.error('onOpen执行错误:', err.message, err.stack); } } - 菜单生成的条件限制:若菜单生成逻辑包含条件判断(如仅特定文档类型显示),审核环境的测试文档可能不满足条件,导致菜单不生成。
- 冗余OAuth权限:
appsscript.json中请求不必要的权限,可能引发审核环境授权流程异常,间接影响菜单加载。仅保留邮件合并必需的权限(如https://www.googleapis.com/auth/gmail.send、https://www.googleapis.com/auth/spreadsheets)。
内容的提问来源于stack exchange,提问作者Hadizat Abdulhakieem
相关产品推荐
相关产品推荐

