Node.js Oracle 数据库驱动(node-oracledb)中负整数读取问题的分析与解决

2025-07-02 23:34:52作者：舒璇辛Bertina

问题背景

在Node.js应用中使用node-oracledb驱动连接Oracle数据库时，部分用户遇到了一个间歇性出现的内部错误："NJS-111: internal error: read a negative integer when expecting a positive integer at position 4475 of packet 80463"。该错误主要发生在Oracle 12c数据库环境中，且难以在本地复现。

错误表现

错误发生时，系统会抛出以下异常堆栈：

driverError: Error: NJS-111: internal error: read a negative integer when expecting a positive integer at position 4411 of packet 19862
  at Object.throwErr (/app/node_modules/oracledb/lib/errors.js:647:10)
  at ReadPacket._readInteger (/app/node_modules/oracledb/lib/impl/datahandlers/buffer.js:95:16)
  at ReadPacket.readUB4 (/app/node_modules/oracledb/lib/impl/datahandlers/buffer.js:508:17)
  at ExecuteMessage.processColumnData (/app/node_modules/oracledb/lib/thin/protocol/messages/withData.js:502:26)
  at ExecuteMessage.processRowData (/app/node_modules/oracledb/lib/thin/protocol/messages/withData.js:378:22)

问题根源

经过深入分析，开发团队发现该问题与LOB(大对象)列的处理逻辑有关。具体来说，当驱动程序处理包含LOB类型列的查询结果时，在特定情况下会错误地重置查询变量数组(queryVars)，导致后续读取数据时出现类型不匹配。

问题代码位于lib/thin/protocol/messages/withData.js文件中，在处理描述信息(TNS_MSG_TYPE_DESCRIBE_INFO)时，不必要地清空了queryVars数组：

if (messageType === constants.TNS_MSG_TYPE_DESCRIBE_INFO) {
  buf.skipBytesChunked();
  const prevQueryVars = this.statement.queryVars;
  this.statement.queryVars = [];  // 这行导致了问题
  this.statement.numQueryVars = 0;
  // ...其他代码
}

解决方案

修复方案非常简单，只需移除重置queryVars数组的代码行。修改后的代码如下：

if (messageType === constants.TNS_MSG_TYPE_DESCRIBE_INFO) {
  buf.skipBytesChunked();
  const prevQueryVars = this.statement.queryVars;
  this.statement.numQueryVars = 0;
  // ...其他代码保持不变
}