现象：脚本执行后的意外停顿
在使用 node-oracledb 6.0 的默认 Thin 模式开发 Node.js 应用时，开发者可能会观察到一个令人困惑的现象：即使所有数据库操作 seemingly 完成，脚本也不会立即终止，而是会停顿数秒后才退出。这种延迟尤其在使用 time 命令衡量脚本执行时间时表现得非常明显。
考虑以下 Node.js 脚本，它连接到 Oracle 数据库并执行一个简单的查询，但有意不关闭数据库连接：
const oracledb = require('oracledb');
const dbConfig = require('./dbconfig.js'); // 包含数据库连接配置
async function runApp() {
let connection;
try {
connection = await oracledb.getConnection(dbConfig);
const result = await connection.execute(`select * from dual`);
console.dir(result.rows, { depth: null });
console.log('未关闭连接');
// 注意：此处 connection.close() 被注释掉
} catch (err) {
console.error(err);
} finally {
// 即使在 finally 块中，如果 connection.close() 被注释，问题依然存在
// if (connection) {
// try {
// await connection.close();
// console.log('连接已关闭');
// } catch (err) {
// console.error(err);
// }
// }
}
}
runApp();当我们在 Linux 环境下使用 time 命令运行上述脚本时，会发现明显的延迟：
$ time node t.js [ [ 'X' ] ] 未关闭连接 real 0m8.187s # 实际执行时间长达8秒多 user 0m0.092s sys 0m0.017s
然而，如果我们将 await connection.close() 取消注释，显式关闭连接：
const oracledb = require('oracledb');
const dbConfig = require('./dbconfig.js');
async function runApp() {
let connection;
try {
connection = await oracledb.getConnection(dbConfig);
const result = await connection.execute(`select * from dual`);
console.dir(result.rows, { depth: null });
console.log('正在关闭连接');
await connection.close(); // 显式关闭连接
console.log('连接已关闭');
} catch (err) {
console.error(err);
} finally {
// 在实际应用中，通常会在 finally 块中确保连接关闭
// if (connection) {
// try {
// await connection.close();
// } catch (err) {
// console.error(err);
// }
// }
}
}
runApp();再次运行，延迟便会消失：
$ time node t.js [ [ 'X' ] ] 正在关闭连接 连接已关闭 real 0m0.249s # 实际执行时间恢复正常 user 0m0.082s sys 0m0.017s
在 node-oracledb 的早期版本或使用 Thick 模式时，即使不显式关闭连接，也通常不会出现这种延迟。
深入解析：Thin 模式下的资源管理
这种行为上的差异源于 node-oracledb 6.0 Thin 模式与 Thick 模式（或早期版本）在底层网络资源管理方式上的根本不同。
Thin 模式的工作原理： 在 node-oracledb 6.0 的 Thin 模式中，该模块直接管理与 Oracle 数据库建立的网络套接字（sockets）。这些套接字是 Node.js 事件循环已知的资源。这意味着，只要这些套接字处于打开状态，Node.js 的事件循环就会认为仍有待处理的 I/O 操作，从而阻止应用程序立即终止。 当没有显式调用 connection.close() 时，这些套接字会保持打开状态。Node.js 内部有一个“终结注册表”（finalization registry）机制，它会在持有这些套接字的对象被 JavaScript 垃圾回收器回收时，强制关闭这些套接字。然而，垃圾回收的时机是不可预测的，这正是导致脚本在执行完毕后出现数秒不确定延迟的原因。应用程序必须等待垃圾回收器介入并清理这些资源后，Node.js 进程才能最终退出。
Thick 模式（或早期版本）的工作原理： 与 Thin 模式不同，在 Thick 模式下或 node-oracledb 的早期版本中，底层的网络连接和套接字是由外部的 Oracle 客户端库（Oracle Client library）管理的。这个客户端库通常是一个 C/C++ 库，它在 Node.js 进程之外维护这些资源。 对于 Node.js 运行时而言，它对这些由外部库管理的套接字一无所知，也不会将它们视为需要保持事件循环活跃的因素。因此，当 Node.js 脚本中的所有 JavaScript 异步操作完成后，即使 Oracle 客户端库内部的连接尚未完全关闭，Node.js 也会认为其事件循环已空闲，从而愉快地终止进程，不会出现额外的延迟。
解决方案与最佳实践：显式关闭连接
理解了背后的机制，解决方案就变得非常明确：始终显式关闭数据库连接。
通过调用 await connection.close()，我们指示 node-oracledb 立即释放与该连接关联的所有底层网络资源。这会通知 Node.js 事件循环，相关的 I/O 操作已完成，并且没有未决的网络活动需要等待。一旦所有连接都被显式关闭，Node.js 进程便能立即判断事件循环已空闲，从而快速终止。
推荐的代码结构：
const oracledb = require('oracledb');
const dbConfig = require('./dbconfig.js');
async function runApp() {
let connection; // 声明 connection 变量
try {
connection = await oracledb.getConnection(dbConfig);
const result = await connection.execute(`select * from dual`);
console.dir(result.rows, { depth: null });
console.log('数据库操作完成');
} catch (err) {
console.error('执行数据库操作时发生错误:', err);
} finally {
// 确保无论是否发生错误，连接都会被关闭
if (connection) {
try {
await connection.close();
console.log('数据库连接已安全关闭。');
} catch (err) {
console.error('关闭数据库连接时发生错误:', err);
}
}
}
}
runApp();注意事项：
- try...finally 块： 在实际应用中，使用 try...finally 块来包裹数据库操作是最佳实践。这可以确保即使在数据库操作过程中发生错误，连接也能被可靠地关闭，避免资源泄露。
- 连接池： 对于长时间运行的应用程序（如 Web 服务器），不应在每次请求后立即关闭连接，而应使用 node-oracledb 的连接池功能。连接池会自动管理连接的生命周期，并在应用程序退出时负责关闭所有池中的连接。然而，对于短生命周期的脚本，显式关闭单个连接仍然是必要的。
- 资源管理的重要性： 显式关闭连接不仅仅是为了避免脚本终止延迟，更是良好资源管理的关键。它能防止因未释放资源导致的内存泄漏、端口耗尽或其他潜在的系统不稳定问题。
总结
node-oracledb 6.0 Thin 模式下脚本结束时的延迟是其底层网络资源管理机制的预期行为。由于 Thin 模式直接管理网络套接字并将其注册到 Node.js 事件循环中，这些未关闭的套接字会阻止进程立即终止。通过在代码中显式调用 await connection.close()，开发者可以确保网络资源及时释放，从而实现脚本的即时终止，并遵循数据库连接管理的最佳实践。这一改变强调了在现代 Node.js 数据库驱动中，对资源生命周期进行精确控制的重要性。
