Google App Script：HTML页面脚本无法调用外部及库函数问题

你的核心问题是未理清Google Apps Script中**客户端（HTML内JavaScript）与服务端（.gs脚本/库）**的执行环境隔离规则：客户端无法直接调用服务端API或库函数，且google.script.run是异步操作，不能同步获取返回值。

关键错误点 #

• 客户端JS不能调用服务端的Logger.log()，需用浏览器原生console.log()替代。
• 库中receiveLink()若为服务端函数，不能直接在客户端通过let uwow = LibIdentifier.receiveLink()调用，必须通过google.script.run异步触发。
• google.script.run是异步机制，需通过成功/失败回调处理返回结果，不能同步赋值。
• 服务端userClicked()函数同样需通过google.script.run调用。

修正实现步骤 #

1. 服务端（.gs/库）配置

确保库已正确添加到项目，且目标函数为公开可调用（函数名首字母大写）：

// 库或本地服务端脚本中的函数示例
function ReceiveLink() {
  // 自定义业务逻辑，返回需要传递给客户端的值
  return "从库获取的目标内容";
}

function UserClicked() {
  // 服务端侧的点击逻辑处理
  console.log("用户触发按钮点击（服务端日志）");
}

2. 客户端HTML代码修正

调整脚本逻辑，用google.script.run的异步回调调用服务端/库函数：

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
    <?!= include('Stylesheet'); ?>
  </head>
  <body>
    <h1>Welcome</h1>
    <p>Please enjoy this helpful script.</p>
    <?!= include('JavaScript'); ?>

    <div>
      <label for="sheetLink">Google Sheets Link:</label>
      <input type="text" id="myInput">
      <button id="myButton" onclick="handleButtonClick()">Click me</button>
    </div>

    <script>
      function handleButtonClick() {
        var userInput = document.getElementById("myInput").value;
        console.log(userInput);
        alert(userInput);

        // 异步调用库中公开函数，通过回调处理结果
        google.script.run
          .withSuccessHandler(function(uwow) {
            console.log(uwow);
            alert(uwow);
            // 获取返回值后，调用服务端的UserClicked函数
            google.script.run.UserClicked();
          })
          .withFailureHandler(function(error) {
            console.error("调用失败:", error);
            alert("出错了：" + error.message);
          })
          .ReceiveLink(); // 与库中函数名严格一致（大小写敏感）
      }
    </script>
  </body>
</html>

额外注意事项 #

• 库中函数需在库项目中设置为公开，发布版本时确认权限允许外部调用。
• google.script.run调用的函数名必须与服务端/库中函数名完全匹配（大小写敏感）。
• 若include('JavaScript')引入的是服务端JS，该写法无效，服务端代码不能直接嵌入客户端环境。
• 可通过浏览器F12开发者工具的控制台查看详细报错信息，比alert更直观。

内容的提问来源于stack exchange，提问作者Deo Haganta Depari