Oracle Node.js驱动(node-oracledb)6.6.0版本的打包问题解析

Oracle官方提供的Node.js数据库驱动node-oracledb在6.6.0版本中引入了一个值得开发者注意的变化。这个变化主要影响了使用构建工具(如esbuild、Webpack等)打包项目的开发者。

在6.6.0版本中，node-oracledb新增了对Azure和OCI(Oracle Cloud Infrastructure)配置提供程序的支持。这一功能是为了配合Oracle Database 23ai的新特性——集中式配置提供程序。实现这一功能的方式是在代码中动态引入了几个第三方SDK包：

• @azure/app-configuration
• @azure/identity
• @azure/keyvault-secrets
• oci-common
• oci-objectstorage
• oci-secrets

这些依赖项是通过条件require语句引入的，意味着它们只在特定功能被使用时才会被加载。然而，这种动态引入方式会给构建工具带来挑战，特别是当开发者使用esbuild等工具进行打包时。

当开发者尝试使用esbuild的--bundle选项打包包含node-oracledb的项目时，构建工具会报错，提示无法解析上述依赖包。这是因为构建工具在静态分析阶段无法确定这些依赖是否会被使用，因此会尝试将它们包含在最终的包中。

解决这个问题有两种主要方法：

1. 将依赖标记为外部依赖：通过构建工具的配置将这些包标记为外部依赖，不包含在最终的包中。例如在esbuild中使用--external参数，或在Webpack配置中添加externals。

2. 显式安装依赖：如果项目确实需要使用这些Azure或OCI功能，可以显式安装这些依赖包。但要注意这会导致最终的包体积显著增加。

对于使用Next.js框架的开发者，解决方案略有不同。可以在next.config.js中通过配置serverExternalPackages将oracledb标记为外部包，或者通过自定义Webpack配置将这些特定依赖标记为外部。

值得注意的是，这些新增的依赖项对于不使用Azure或OCI配置提供程序功能的开发者来说是完全可选的。Oracle官方建议开发者根据实际需求选择最适合的解决方案，而不是盲目添加所有依赖项。

这一变化反映了现代数据库驱动向云原生和配置集中化管理的发展趋势，同时也提醒开发者在升级依赖版本时需要关注其可能带来的构建配置变化。