Apps Script V8运行时下突发Jdbc未定义报错如何解决

这是2022年7月Google Apps Script团队针对V8 Runtime推送内置服务懒加载机制灰度上线引发的官方bug，和代码逻辑无关：

• 灰度前V8启动时会全量初始化所有内置服务的全局对象，直接赋值var j = Jdbc可以正常拿到对象引用
• 灰度后V8改为按需加载逻辑，只有实际调用服务的公开方法时才会初始化对应全局对象，仅引用服务对象本身不会触发加载，直接访问就会抛出ReferenceError: Jdbc is not defined错误
• 7月4日代码运行正常，是因为当时灰度规则还未覆盖到所属的项目/账号节点

关闭V8回退旧运行时虽然能临时解决，但旧Rhino运行时已停止功能迭代，后续会逐步下线，加上项目本身存在旧运行时不兼容的代码，该方案不推荐使用。

• 先做基础校验：打开脚本编辑器左侧的「服务」面板，确认Jdbc服务处于已添加状态，部分灰度场景下已添加的服务会出现状态异常，移除Jdbc后重新添加，再运行原测试代码验证，少部分账号下该操作可直接修复问题。
• 单处代码临时修复：如果只有少量位置存在直接赋值服务对象的逻辑，在赋值前加一行无业务副作用的方法调用，触发服务初始化即可，修复后的测试代码如下：

function myFunction() {
  // 触发Jdbc服务初始化，无实际业务影响
  Jdbc.parseDate('1970-01-01');
  var j = Jdbc;
  // 后续原有逻辑无需修改，可正常通过j调用Jdbc的所有方法
}

• 批量代码兼容方案：如果项目内大量存在直接引用内置服务对象的写法，不需要逐行修改，封装一个统一的服务获取工具函数即可，示例：

/**
 * 触发内置服务初始化并返回服务对象
 * @param {string} serviceName 内置服务名称
 * @returns {object} 服务实例
 */
function getService(serviceName) {
  const triggerMap = {
    Jdbc: () => { Jdbc.parseDate('1970-01-01'); return Jdbc; },
    // 后续如果其他内置服务出现相同未定义错误，按照相同格式补充触发逻辑即可
  };
  return triggerMap[serviceName]();
}

// 业务代码中替换原有的直接赋值逻辑即可
function testCase() {
  const jdbc = getService('Jdbc');
  // 后续数据库操作逻辑完全不需要改动
}

• 长期注意事项：后续编写V8 Runtime下的Apps Script代码，尽量避免单独引用服务对象不调用方法的写法，直接通过服务对象链式调用方法（比如Jdbc.getConnection(xxx)）不会触发该bug，因为方法调用本身就会触发懒加载逻辑。

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