升级Node.js后oracledb连接报错Cannot read '_getConnection' of undefined

排查步骤 #

• 校验oracledb版本与Node版本兼容性

oracledb v5.1.0官方支持的Node.js最高版本为v14.x，当前使用的Node v16.9.1超出兼容范围，会导致底层绑定编译异常、模块导出异常等问题。

• 校验getConnection方法导入是否正确

现有业务代码中直接调用getConnection(POSTargetConfig)，未显式从oracledb模块导入该方法，也没有提前初始化oracledb连接池的前提下，getConnection本身就是undefined，调用其内部的_getConnection自然触发报错。

• 校验oracledb二进制编译是否正常

升级Node版本后，原有node_modules中编译好的oracledb二进制绑定与新Node版本不匹配，会导致模块加载不完全，方法缺失。可执行npm rebuild oracledb重新编译绑定，确认是否是编译问题导致的异常。

• 校验本地Oracle Instant Client版本

Node v16对应的高版本oracledb要求Oracle Instant Client版本不低于19.3，需检查服务器上的Instant Client版本是否匹配。

解决方案 #

• 方案一：升级oracledb到兼容版本
  执行命令升级oracledb和对应的类型定义，v5.5.0版本兼容Node.js 12~18，无需修改原有业务逻辑：

npm install oracledb@5.5.0 @types/oracledb@5.5.0

• 方案二：修正业务代码中的方法调用
  确保文件头部正确导入oracledb，修改getOracleConnection方法的调用逻辑：

import oracledb from 'oracledb'

export const getOracleConnection = async () => {
   try {
      return await oracledb.getConnection(POSTargetConfig)
   } catch (error) {
      console.log("Errorrrrrrrrr:  " + error.message)
      await TraceLog("Error", error.message);
      await onRejected();
   }
}

• 方案三（依赖不允许升级时可选）：降级Node.js版本到v14.x LTS，即可兼容现有oracledb v5.1.0版本。

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