Google Sheets插件仅显示Help菜单，授权与菜单加载问题排查求助

问题概述 #

提交Google Sheets插件代码审核后，验证反馈显示插件安装后仅出现「Help」菜单，自定义菜单选项未加载。审核提示需正确使用onInstall()和onOpen()函数生成菜单，并遵循编辑器插件授权生命周期规范。

代码问题分析 #

从提供的代码来看，存在以下关键问题：

1. addToUi()重复调用：addStandardMenuItems函数中已调用menu.addToUi()，回到onOpen后又再次调用，同一个菜单实例多次添加到UI会导致创建异常。
2. 未授权状态无菜单：处于AuthMode.NONE（未授权）状态时，代码仅弹出授权提示就直接return，未创建任何自定义菜单，不符合Google插件规范（未授权时应显示引导授权的基础菜单）。
3. authorizeAddon函数错误：
   • 引用未定义的变量ss，会抛出错误中断流程
   • UrlFetchApp.fetch调用参数错误，第二个请求传入的是权限字符串而非有效API地址
   • 存在无实际作用的冗余代码（如ScriptApp.getProjectTriggers()）
4. markPromptFormulas执行时机不当：若该函数依赖授权后的资源访问，在AuthMode.LIMITED状态下调用会因权限不足抛出异常，导致菜单加载失败。

排查与修复步骤 #

• 修复菜单重复添加问题：删除addStandardMenuItems函数中的.addToUi()，仅在onOpen函数末尾统一调用menu.addToUi()。
• 优化未授权状态逻辑：在AuthMode.NONE分支中添加引导授权的菜单项，而非直接返回。例如添加「🔑 授权插件」选项触发授权流程。
• 修正authorizeAddon函数：
  • 定义ss变量为SpreadsheetApp.getActiveSpreadsheet()
  • 修正UrlFetchApp.fetch调用，获取用户信息时添加授权头
  • 移除无效请求调用和冗余代码
• 调整markPromptFormulas执行时机：将该函数放在try-catch块中执行，避免异常中断菜单加载；或确保其在有限授权状态下也能安全运行。
• 测试授权全流程：验证安装后、未授权、已授权三种状态下的菜单显示，确保每个状态都能加载对应菜单。
• 检查OAuth权限范围：确认appsscript.json中声明了所有必要的权限（如https://www.googleapis.com/auth/spreadsheets、https://www.googleapis.com/auth/script.external_request等）。

修正后的代码示例 #

function onInstall(e) {
  onOpen(e);
}

function onOpen(e) {
  const ui = SpreadsheetApp.getUi();
  const menu = ui.createAddonMenu();
  
  if(e && e.authMode === ScriptApp.AuthMode.NONE){
    // 未授权时显示授权引导菜单
    menu.addItem('🔑 授权插件', 'showAuthorizationAlert');
  }else{
    // 已授权/有限授权时加载完整菜单
    addStandardMenuItems(menu);
    // 安全执行markPromptFormulas，避免异常中断菜单加载
    try {
      markPromptFormulas();
    } catch (err) {
      Logger.log('执行markPromptFormulas失败: ' + err.toString());
    }
  }
  menu.addToUi(); // 统一添加菜单到UI
}

function addStandardMenuItems(menu) {
  menu
    .addItem('📚ㅤSheet Library', 'openSheetLibrarySidebar')
    .addItem('⚙️ㅤSheet Settings', 'showSettingsSidebar');
  // 移除此处的addToUi()调用
}

function showAuthorizationAlert() {
  const ui = SpreadsheetApp.getUi();
  ui.alert('需要授权', '请授权该插件以启用全部功能。', ui.ButtonSet.OK);
  // 引导用户通过菜单触发授权，而非直接调用authorizeAddon（避免权限不足）
}

function authorizeAddon() {
  try {
    const ss = SpreadsheetApp.getActiveSpreadsheet();
    const userEmail = Session.getActiveUser().getEmail();
    // 正确调用用户信息API并携带授权头
    const userProfile = UrlFetchApp.fetch('https://www.googleapis.com/oauth2/v1/userinfo', {
      headers: { Authorization: 'Bearer ' + ScriptApp.getOAuthToken() }
    });
    const sheets = ss.getSheets();
    const readOnly = ss.getRange('A1').getValue();
  } catch (e) {
    Logger.log('授权失败: ' + e.toString());
  }
}

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