Google Apps Script WebApp回调调用服务端函数问题排查

我耗时数小时尝试开发一个简单的Apps Script WebApp，预期实现逻辑为：当WebApp服务端函数执行成功后，将执行结果返回给客户端（index.html），随后自动调用下一个服务端函数。但实际运行中遇到异常：无法在回调函数内部调用新的服务端函数——第一个回调函数可正常执行（弹出"Callback1"提示框），但后续的服务端函数createSheetsLogfile(selectedLabel)并未被触发。
请问我的代码存在什么错误？是否Google Apps Script不支持在回调函数内调用服务端函数？

index.html #

<button onclick="archiveSBEmails()">Start archiving</button>

<script>
var selectedLabel = "";

function archiveSBEmails(){
    selectedLabel = "Testlabel_1";
    google.script.run.withSuccessHandler(callbackFolderCreated).createFolder(selectedLabel);
 } 
       
function callbackFolderCreated(){
     alert("Callback1");
    google.script.run.withSuccessHandler(callbackLogfileCreated).createSheetsLogfile(selectedLabel);      
}


function callbackLogfileCreated(logfileURL){
    alert("Callback2");
    google.script.run.withSuccessHandler(callbackBackupCompleted).BackupGmailToDrive(selectedLabel);     
}     


function callbackBackupCompleted(){
//...
 }


</script>

code.gs #

function doGet() {
  return HtmlService.createHtmlOutputFromFile('index')
            .setSandboxMode(HtmlService.SandboxMode.IFRAME);
}

function createFolder(selectedLabel){  
  //调用自index.html
  // 业务逻辑代码...
    return true;
}

function createSheetsLogfile(selectedLabel){
  //调用自index.html
  //业务逻辑代码...
  return logfileURL;
}

function BackupGmailToDrive(selectedLabel){
  //调用自index.html
  //业务逻辑代码..
  return true;
}

Google Apps Script 完全支持在google.script.run的成功回调里嵌套调用其他服务端函数，不存在平台层面的功能限制。
你遇到的问题基本由以下两类原因导致：

• 所有google.script.run调用都未绑定失败回调，服务端函数执行报错时前端会完全静默失败，没有任何提示，看起来就像函数没被触发。只要服务端代码出现变量未定义、权限不足、返回值无法序列化这类问题，就会出现你描述的现象。
• 服务端createSheetsLogfile函数中logfileURL变量作用域错误，很可能你在条件分支、内部函数等局部作用域里声明了这个变量，外层return语句访问不到该变量，直接抛出引用错误导致函数中断。

修复步骤 #

1. 为所有服务端调用添加统一的错误处理，先明确具体报错信息：

// 全局错误处理
function handleServerError(err) {
  alert("服务端执行错误：" + err.message);
  console.error("服务端报错详情：", err);
}

function archiveSBEmails(){
  selectedLabel = "Testlabel_1";
  google.script.run
    .withSuccessHandler(callbackFolderCreated)
    .withFailureHandler(handleServerError)
    .createFolder(selectedLabel);
} 
       
function callbackFolderCreated(){
  alert("Callback1");
  google.script.run
    .withSuccessHandler(callbackLogfileCreated)
    .withFailureHandler(handleServerError)
    .createSheetsLogfile(selectedLabel);      
}

function callbackLogfileCreated(logfileURL){
  alert("Callback2");
  google.script.run
    .withSuccessHandler(callbackBackupCompleted)
    .withFailureHandler(handleServerError)
    .BackupGmailToDrive(selectedLabel);     
}

2. 检查createSheetsLogfile的变量声明逻辑，确保logfileURL在函数顶层作用域声明，避免块级作用域导致的引用错误：

错误示例（条件内声明变量，外部无法访问）：

function createSheetsLogfile(selectedLabel){
  if (selectedLabel) {
    const logfileURL = SpreadsheetApp.create(selectedLabel + "_log").getUrl();
  }
  return logfileURL; // 此处抛出ReferenceError: logfileURL is not defined
}

正确写法：

function createSheetsLogfile(selectedLabel){
  let logfileURL = ""; // 函数顶层先声明变量
  if (selectedLabel) {
    logfileURL = SpreadsheetApp.create(selectedLabel + "_log").getUrl();
  }
  return logfileURL;
}

3. 额外注意：服务端函数的返回值必须是可序列化的基础类型（字符串、数字、布尔值、普通对象、数组），不要直接返回Spreadsheet、File、Folder这类Apps Script原生对象，这类对象无法跨端传递，也会导致调用失败。

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