Node-JDBC异常问题：引入JDBC库后程序无法正常退出

问题场景 #

我编写了如下简单的test.js文件：

// test.js
const JDBC = require('jdbc');

console.log('should end')

在Windows 11、Node.js v14.19.1环境下执行时，程序会一直挂起无法终止；但注释或移除const JDBC = require('jdbc')这行代码后，程序能正常结束。

核心原因 #

jdbc库在初始化阶段会创建后台线程（比如JVM相关的守护线程、连接池维护线程），这些线程会占用Node.js事件循环的活跃资源，导致Node.js进程不会自动退出——Node.js的事件循环只有在所有异步资源、后台线程都释放后才会终止进程。

可行解决办法 #

• 强制终止进程：如果只是测试或不需要保留JDBC资源，在代码末尾直接调用process.exit()强制结束进程：

  // test.js
  const JDBC = require('jdbc');
  
  console.log('should end');
  process.exit(0); // 0代表正常退出状态码
  

• 显式释放JDBC资源：如果需要使用JDBC进行数据库操作，在完成所有操作后必须手动关闭连接池或相关资源，让事件循环无活跃资源后自动退出：

  // test.js
  const JDBC = require('jdbc');
  
  // 示例：初始化并使用JDBC连接
  async function run() {
    // 假设这里有初始化连接池、执行查询等逻辑
    // ...
  
    // 操作完成后关闭连接池
    await JDBC.close();
    console.log('should end');
  }
  
  run();
  

• 升级JDBC库版本：部分旧版本的jdbc库存在资源泄漏问题，尝试升级到最新稳定版，可能已经修复了进程无法自动退出的bug。

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