本文旨在解决使用node-oracledb在thin模式下连接oracle数据库时遇到的“密码验证器类型0x939不受支持”错误。该问题通常源于数据库使用了较旧的密码哈希算法。教程将详细介绍针对不同oracle数据库版本的解决方案，包括启用thick模式、调整数据库参数以及重置用户密码等，以确保node.js应用能够顺利连接oracle数据库。
在使用Node.js配合node-oracledb模块连接Oracle数据库时，开发者可能会遇到一个特定的错误信息：“password verifier type 0x939 is not supported by node-oracledb in Thin mode”。这个错误表明node-oracledb的Thin模式无法识别或处理数据库用户所使用的旧版密码验证器类型。通常，这与Oracle数据库的密码哈希算法版本有关，尤其是当数据库或用户密码自Oracle 10g或更早版本沿用至今时。
为了解决这一问题，我们需要根据所使用的Oracle数据库版本采取不同的策略。
1. 针对Oracle Database 11gR2 或更早版本
对于较旧的Oracle数据库版本，Thin模式可能无法直接支持其默认的密码验证器。在这种情况下，主要有两种解决方案：
1.1 启用 Thick 模式
node-oracledb的Thick模式通常具有更广泛的兼容性，能够支持多种Oracle数据库版本和密码验证器类型。通过调用initOracleClient()函数，可以在应用程序中启用Thick模式。这要求您的系统上已安装Oracle客户端库（如Instant Client）。
const oracledb = require('oracledb');
try {
// 启用node-oracledb的Thick模式
// 确保系统已安装Oracle客户端库（例如Instant Client）
// 并且ORACLE_HOME或PATH/LD_LIBRARY_PATH环境变量已正确配置
oracledb.initOracleClient({ libDir: '/path/to/your/oracle/instantclient' });
console.log('Oracle Thick mode initialized successfully.');
} catch (err) {
console.error('Error initializing Oracle Thick mode:', err);
process.exit(1);
}
async function run() {
let connection;
try {
connection = await oracledb.getConnection({
user: "your_user",
password: "your_password",
connectString: "your_connection_string" // 例如: "localhost/ORCLPDB1"
});
console.log("Successfully connected to Oracle Database in Thick mode.");
// 执行您的数据库操作
// ...
} catch (err) {
console.error("Error connecting to database:", err);
} finally {
if (connection) {
try {
await connection.close();
console.log("Connection closed.");
} catch (err) {
console.error("Error closing connection:", err);
}
}
}
}
run();注意事项：
- libDir参数应指向您的Oracle Instant Client库文件的路径。
- 启用Thick模式会增加部署的复杂性，因为需要额外安装Oracle客户端库。
1.2 升级数据库
从长远来看，升级Oracle数据库到12c或更高版本是解决此类兼容性问题的最佳实践。新版本的数据库通常支持更现代、更安全的密码验证器，并且与node-oracledb的Thin模式有更好的兼容性。
2. 针对Oracle Database 12c 或更高版本
对于Oracle Database 12c及更高版本，通常可以通过调整数据库配置或用户密码来解决此问题，从而继续使用node-oracledb的Thin模式。
2.1 优化 Thin 模式连接
为了在Thin模式下成功连接，可以检查并调整数据库参数和用户密码。
2.1.1 检查 sec_case_sensitive_logon 参数
在某些情况下，sec_case_sensitive_logon 参数的设置可能会影响密码验证。确保此参数不为 FALSE。您可以通过SQL*Plus作为SYSDBA用户执行以下命令来检查其值：
1.修正会员卡升级会员级别的判定方式2.修正了订单换货状态用户管理中心订单不显示的问题3.完善后台积分设置数据格式验证方式4.优化前台分页程序5.解决综合模板找回密码提示错误问题6.优化商品支付模块程序7.重写优惠卷代码8.优惠卷使用方式改为1卡1号的方式9.优惠卷支持打印功能10.重新支付模块，所有支付方式支持自动对账11.去掉规格库存显示12.修正部分功能商品价格显示4个0的问题13.全新的支
SHOW PARAMETER sec_case_sensitive_logon;
如果该参数为 FALSE，可能需要将其更改为 TRUE 或将其移除（在Oracle 21c及更高版本中，此参数已被移除）。请注意，更改此参数可能需要重启数据库实例。
重要提示： 在Oracle Database 21c及更高版本中，sec_case_sensitive_logon 参数已被移除。
2.1.2 重置用户密码
如果上述检查未能解决问题，最有效的解决方案通常是重置受影响的数据库用户的密码。重置密码会强制Oracle数据库为该用户生成新的、更现代的密码验证器，这些验证器通常与node-oracledb的Thin模式兼容。
作为SYSDBA或其他具有ALTER USER权限的用户，执行以下SQL命令：
ALTER USER your_user IDENTIFIED BY your_new_password;
将 your_user 替换为实际的用户名，将 your_new_password 替换为新密码。重置密码后，尝试使用新的密码通过node-oracledb的Thin模式进行连接。
2.2 退回 Thick 模式
如果以上Thin模式的优化措施仍无法解决问题，或者由于环境限制无法进行数据库参数调整或密码重置，您仍然可以选择回退到启用Thick模式的方案。具体操作请参考上文“1.1 启用 Thick 模式”部分。
总结与最佳实践
“password verifier type 0x939 is not supported”错误是由于Oracle数据库中使用了旧版密码验证器与node-oracledb Thin模式的兼容性问题引起的。
- 推荐方案： 对于Oracle 12c及更高版本，优先尝试通过检查sec_case_sensitive_logon参数并重置用户密码来解决，以便继续使用更轻量级的Thin模式。
- 兼容性方案： 对于Oracle 11gR2及更早版本，或当Thin模式优化方案无效时，启用Thick模式是一个可靠的替代方案。
- 长期策略： 升级数据库到最新版本是解决此类兼容性问题的根本方法，同时也能获得更好的性能、安全性和新特性。
在开发和部署Node.js应用程序时，理解和解决此类数据库连接问题至关重要。选择最适合您项目和环境的解决方案，确保数据库连接的稳定性和安全性。
