已发布的GAS库变为空对象，如何排查修复？

可能原因 #

你的GAS库在新项目中加载为空对象、旧项目却能正常使用，结合操作背景，核心原因大概率是以下几点：

1. 添加JSDoc时引入了语法错误，导致库脚本无法正常编译，加载后仅返回空对象。
2. 代码结构修改后，Client类未正确暴露到库的全局作用域，外部脚本无法访问。
3. GAS的缓存机制异常，导致新项目未正确拉取库的有效版本（旧项目因缓存正常不受影响）。

修复步骤 #

1. 排查并修复库代码的语法错误 #

• 打开库的Google Apps Script编辑器，手动运行任意测试函数（比如调用Client的某个静态方法），查看是否有编译或运行报错。
• 检查新增的JSDoc注释：确保所有注释以/**开头、*/结尾，无闭合遗漏；标签（如@class、@param）格式规范，无拼写或语法混乱。
• 若用clasp管理代码，拉取本地代码后用语法检查工具（如ESLint）排查问题，修复后推回并重新发布版本。

2. 确保Client类正确暴露到全局作用域 #

GAS库的公开成员必须是顶级作用域的变量/类/函数，不能嵌套在其他函数或模块内。若修改代码结构时影响了作用域，需确保Client类在顶级作用域声明：

/**
 * 库的主客户端类，包含静态API访问方法
 * @class
 */
class Client {
  /**
   * 获取舰队数据的静态方法
   * @returns {Object} 舰队数据对象
   */
  static getFleetData() {
    // 你的API调用逻辑
  }
}

无需额外export语法，GAS会自动将顶级声明的类作为库的可访问成员，外部脚本可通过PssFleetData.Client调用。

3. 强制刷新新项目的库引用与缓存 #

• 删除新项目中的PssFleetData库引用，保存脚本后重新添加，并选择之前确认可用的旧版本测试。
• 切换库的「开发模式」（勾选后再取消），强制GAS重新加载库代码。
• 关闭所有相关脚本编辑器标签页，清除浏览器缓存后重新打开新项目脚本。

4. 验证库的发布状态 #

• 确认每个发布版本都完成了「部署为库」操作，且版本号与新项目引用的一致。
• 临时将库的共享权限改为「任何人，甚至匿名用户」，测试是否为权限缓存问题（测试后可改回原设置）。

测试验证 #

修复后在新项目中重新运行测试代码：

console.log(typeof(PssFleetData));
console.log(PssFleetData.Client);
console.log(PssFleetData.Client.getFleetData());

若输出正常显示Client类及方法执行结果，则修复成功。

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