Next.js 13集成node-oracledb遇NJS-045二进制文件加载失败问题咨询

疑问1：该错误是否确实是因为找不到oracledb*.node文件？ #

是的，NJS-045错误的核心原因就是Node.js无法定位到oracledb的二进制扩展文件（oracledb*.node）。oracledb初始化时会尝试加载该二进制文件，当加载路径不正确或文件未被复制到可访问位置时，就会抛出此错误，你看到的“在页面路径下查找”是加载失败时的路径尝试逻辑之一。

疑问2：为何page.js中会相对于页面路径查找该文件而非正确的node_modules目录？ #

这和Next.js 13 App Router的模块处理机制直接相关：

• src/app/accounts/editUsernamePassword/page.js属于App Router下的页面组件，若包含客户端交互逻辑（比如声明了'use client'），会被Webpack当作客户端组件打包。Webpack在打包客户端组件时，会将依赖打包到对应页面的chunk目录下，而oracledb的二进制文件未被正确复制到该chunk的可访问路径，导致加载时从页面所在路径查找。
• src/library/oasis/abcHelper.js大概率是仅在服务器端执行的模块，Next.js对服务器端模块的依赖处理不会进行客户端打包，直接从node_modules读取文件，因此能正常找到二进制文件。

解决方案 #

1. 配置Webpack复制二进制文件

首先安装copy-webpack-plugin：

npm install copy-webpack-plugin --save-dev

在项目根目录的next.config.js中添加Webpack配置，将oracledb的二进制文件复制到客户端打包的可访问路径：

const CopyWebpackPlugin = require('copy-webpack-plugin');

module.exports = {
  webpack: (config, { isServer }) => {
    // 仅客户端打包时复制二进制文件
    if (!isServer) {
      config.plugins.push(
        new CopyWebpackPlugin({
          patterns: [
            {
              from: 'node_modules/oracledb/build/Release/oracledb*.node',
              to: './',
            },
          ],
        })
      );
    }
    return config;
  },
};

2. 推荐：将数据库操作限制在服务器端

如果你的数据库逻辑不需要在客户端执行，建议把oracledb的调用逻辑抽离到服务器端组件或API路由中：

• 创建src/app/api/oracle/route.js，在其中处理数据库查询/操作
• 在page.js中通过fetch调用该API，避免在客户端直接导入oracledb

3. 消除Webpack静态提取警告

配置copy-webpack-plugin后，Webpack会明确知晓需要复制oracledb的二进制文件，之前的“无法静态提取依赖”警告会自动消失。

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