Linux环境部署Node.js应用连接Oracle自治数据库报ORA-28759如何解决

你遇到的两个报错中，核心根因是ORA-28759: failure to open file，这是Oracle客户端无法读取钱包文件触发的底层异常，上层的db.doConnect is not a function是异常传递过程中出现的次生错误，解决底层连接问题后会自动消失。

一、修复ORA-28759钱包文件访问问题 #

按以下检查项逐一核对配置：

• 明确指定钱包目录路径
  Oracle客户端不会自动扫描钱包存放目录，需要在创建连接池的配置中新增configDir参数，填写你服务器上存放钱包的admin文件夹绝对路径（Linux系统路径区分大小写），示例如下：

  await oracledb.createPool({
    user: process.env.DATABASEUSERNAME,
    password: process.env.DATABASEPASSWORD,
    connectString: process.env.DATABASECONNECTIONSTRING,
    configDir: "/home/site/wwwroot/admin" // 替换为Azure Web App上admin文件夹的实际绝对路径
  });
  

• 修正文件夹与文件权限
  Azure Linux Web App默认运行用户为www-data，需要确保admin文件夹和内部所有钱包文件（tnsnames.ora、sqlnet.ora、ewallet.p12等）都开放读取权限，可在Web App的SSH终端执行以下命令赋权：

  chmod 755 /path/to/your/admin
  chmod -R 644 /path/to/your/admin/*
  

• 修正sqlnet.ora配置
  打开钱包内的sqlnet.ora文件，将DIRECTORY参数值修改为服务器上admin文件夹的绝对路径，示例：

  WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY="/home/site/wwwroot/admin")))
  SSL_SERVER_DN_MATCH=yes
  

• 配置TNS_ADMIN环境变量
  在Azure Web App的应用配置页新增环境变量TNS_ADMIN，值为admin文件夹的绝对路径，让Oracle客户端可以找到tnsnames.ora配置文件。

二、修复代码逻辑缺陷 #

当前代码存在几处逻辑错误会导致连接异常：

• 补充连接池别名配置
  你的createPool方法没有指定poolAlias参数，但后续调用getConnection时传入了default别名，会导致找不到对应连接池，需要在连接池配置中新增对应参数：

  await oracledb.createPool({
    user: process.env.DATABASEUSERNAME,
    password: process.env.DATABASEPASSWORD,
    connectString: process.env.DATABASECONNECTIONSTRING,
    configDir: "/home/site/wwwroot/admin",
    poolAlias: 'default' // 新增该配置
  });
  

• 调整连接池初始化逻辑
  连接池仅需在应用启动时初始化一次，不要在每次调用simpleExecute时重复创建连接池，避免资源泄漏和连接冲突。
• 优化异常处理逻辑
  当前代码的simpleExecute方法在catch时直接将错误对象作为返回值返回，上层如果未做错误类型判断，会把错误对象当成正常数据库实例调用方法，触发xxx is not a function类报错。建议在catch块中直接抛出错误，上层通过try/catch统一捕获处理，不要把错误作为正常返回值传递。

三、配置验证 #

所有修改完成后，可先在Azure Web App的SSH终端用tnsping工具测试连接串是否能正常解析，确认钱包配置无误后再重启应用测试接口。

内容的提问来源于stack exchange，提问作者Ronak Shetiya