google.script.run.withSuccessHandler在WebApp正常但Google Sheets侧边栏运行失败

问题核心诱因 #

按触发概率从高到低排列如下：

• 第一：getUser.gs文件存在语法错误，导致服务端函数无法被侧边栏场景正常加载
  你提供的getUser.gs代码开头直接是as long as they are logged into their Google account. */，缺失了注释开头的/*标识，属于语法错误。Google Apps Script中，WebApp部署时默认使用发布时的固定版本代码，而侧边栏运行时始终加载当前编辑态的最新代码。如果你的WebApp是在引入这个语法错误之前部署的，就会出现WebApp运行正常、侧边栏调用失败的现象。
• 第二：load事件触发时google.scriptAPI未完成初始化
  Google Sheets侧边栏的iframe加载逻辑和独立WebApp的加载逻辑存在差异，部分场景下window.load事件触发时，用于和服务端通信的google.script内置API还未完全初始化，此时调用google.script.run就会直接失败。
• 其他辅助诱因：
  • 你没有为google.script.run配置错误捕获回调，无法提前感知具体报错原因，难以定位问题
  • 如果你近期修改了服务端函数的权限需求（比如新增表格读写、用户信息获取权限），侧边栏首次运行时需要重新完成授权，未完成授权的情况下调用服务端函数会直接失败

验证修复方案 #

1. 首先修正getUser.gs的语法错误，在首行补充缺失的/*注释开头标识
2. 给google.script.run调用补充错误回调，方便快速定位问题，示例如下：

google.script.run
  .withSuccessHandler(onUserSuccess)
  .withFailureHandler(err => console.error('调用getUser失败：', err))
  .getUser();

3. 如果是API初始化时序问题，将触发逻辑改为短延迟执行，或者替换为监听DOMContentLoaded事件，也可以直接在脚本末尾同步调用populateList()即可。

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