Google Script侧边栏客户端脚本无法触发服务端函数问题

问题场景 #

在Google Script侧边栏表单提交后，客户端submitForm函数可正常执行（控制台能打印日志），但服务端test函数始终未被触发。

客户端代码 #

<script>
  function submitForm() {
    console.log('Function called!');
    var company = document.getElementById("company").value;
    var companyOtherInput = document.getElementById("company-other-input").value;
    if (company === "Other") {
      company = companyOtherInput;
    }
    var role = document.getElementById("role").value;
    var position = document.getElementById("position").value;
    google.script.run.test();
    console.log(company);
    console.log(role);
    console.log(position);
  }
</script>

服务端测试代码 #

function  test() {
 Browser.msgBox('script running');
 console.log('called');
}

排查与解决步骤 #

1. 修正服务端函数命名问题 #

服务端test函数定义前存在多余空格，Google Script对函数名的空格敏感，会导致google.script.run无法识别函数。修改为：

function test() {
  console.log('服务端函数已调用');
  // 替换Browser.msgBox为适配侧边栏的弹窗方式
  SpreadsheetApp.getUi().alert('script running');
}

2. 添加客户端错误捕获 #

原代码未处理google.script.run的调用失败情况，添加失败回调可直接在浏览器控制台查看错误原因：

google.script.run
  .withFailureHandler(function(error) {
    console.log('服务端调用失败:', error.message);
  })
  .test();

3. 验证侧边栏加载方式 #

确保侧边栏通过Google Script官方API加载，而非直接打开HTML文件：

function showSidebar() {
  var html = HtmlService.createHtmlOutputFromFile('你的侧边栏HTML文件名')
      .setTitle('表单侧边栏');
  // 根据实际使用的服务选择Ui对象，比如DocumentApp/FormApp
  SpreadsheetApp.getUi().showSidebar(html);
}

4. 清除浏览器缓存 #

刷新页面并清除浏览器缓存，或使用隐身模式测试，避免旧代码缓存导致的执行异常。

5. 替换兼容性差的API #

Browser.msgBox在侧边栏环境下存在兼容性问题，建议改用对应服务的Ui.alert()方法，或先仅用console.log验证函数是否被调用（可在Google Script编辑器的「查看」>「日志」中查看服务端日志）。

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