使用Oracle Cloud数据库的Node.js项目部署Azure App Service连接异常求助

核心原因说明 #

你遇到的配置重启失效问题是因为Azure App Service Linux运行环境为容器化架构，所有直接在运行实例中手动修改的系统级配置，都会在实例重启、重新部署时被重置回基础镜像的默认状态，因此必须将依赖和配置集成到你的部署包或通过平台提供的持久化配置入口设置。

操作步骤 #

1. 打包Oracle依赖到项目中 #

• 在你的Node.js项目根目录创建名为oracle的文件夹
• 下载适配Linux x64架构的Oracle Instant Client Basic Light安装包，解压后将所有文件放入上述oracle文件夹
• 将你持有的Oracle wallet压缩包解压后的所有文件（包含tnsnames.ora、cwallet.sso等）也全部放入oracle文件夹

2. 配置App Service持久化环境变量 #

进入Azure门户对应App Service的「配置」页面，在「应用程序设置」板块添加以下变量：

• LD_LIBRARY_PATH：值为/home/site/wwwroot/oracle:$LD_LIBRARY_PATH
• TNS_ADMIN：值为/home/site/wwwroot/oracle
• 你的数据库用户名、密码、TNS服务名等敏感配置也建议在此处配置，避免硬编码到代码中

注：如果你的项目部署路径不是默认的/home/site/wwwroot，请将上述路径修改为对应实际路径

3. 调整代码初始化逻辑 #

在项目中首次调用oracledb的代码前添加初始化逻辑：

const oracledb = require('oracledb');
// 初始化Oracle客户端路径
oracledb.initOracleClient({ libDir: '/home/site/wwwroot/oracle' });

4. 配置依赖编译规则 #

在项目package.json的scripts配置块中添加安装后钩子，避免部署时oracledb版本不匹配：

{
  "scripts": {
    "postinstall": "npm rebuild oracledb",
    // 保留你原有其他scripts配置
  }
}

5. 额外网络检查 #

如果完成上述配置后仍无法连接，需要到Oracle Cloud数据库的网络访问控制页面，将Azure App Service的所有出站IP地址添加到白名单中，Oracle Cloud默认会拦截未在白名单内的访问请求。

完成所有配置后重新部署项目、重启App Service即可正常连接数据库。

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