AWS Lambda Node.js配置node-oracledb层后模块找不到问题排查

你遇到的问题大概率是层的压缩结构不符合Lambda要求，再加上可能的环境兼容性问题，我来帮你一步步排查和解决：

1. 最核心的问题：层的压缩方式错误 #

Lambda层的内容会被解压到/opt目录下，Node.js会自动从/opt/nodejs/node_modules路径查找模块。但从你的文件夹结构来看，你应该是把外层的Lambda-Layer-1整个压缩成了zip包——这样解压后，oracledb的实际路径会变成/opt/Lambda-Layer-1/nodejs/node_modules/oracledb，Node.js根本找不到这个位置。

修正方法：

• 打开Lambda-Layer-1文件夹，直接选中里面的lib和nodejs两个文件夹
• 将这两个文件夹直接压缩成zip包（不要包含外层的Lambda-Layer-1目录）
• 重新上传这个新的zip包作为Lambda层，替换原来的版本

2. 验证node-oracledb的环境兼容性 #

node-oracledb是带有二进制依赖的模块，如果你是在本地（Windows/macOS）安装的包，直接上传到Lambda（Amazon Linux环境）可能会出现兼容性问题，甚至路径正确后也无法加载。

正确的安装方式：
建议在Amazon Linux环境下安装node-oracledb 3.1.2（比如用EC2实例，或者Lambda的官方Docker镜像）：

# 创建并进入nodejs目录
mkdir -p nodejs && cd nodejs
# 初始化package.json
npm init -y
# 安装适配Lambda环境的oracledb包
npm install oracledb@3.1.2 --arch=64 --platform=linux

安装完成后，把nodejs和lib文件夹一起压缩成zip包上传。

3. 确认Lambda层的关联和环境变量 #

• 进入你的Lambda函数配置页面，检查「Layers」部分是否已经正确附加了你的Oracle层，并且选择了最新版本
• 可以在Lambda代码中添加日志，验证Node.js的模块查找路径：

  console.log('NODE_PATH:', process.env.NODE_PATH);
  console.log('Module search paths:', module.paths);
  

  正常情况下，/opt/nodejs/node_modules应该出现在输出的路径列表中，如果没有，说明层没有被正确加载。

4. 额外的排查点 #

• 确认你的Lambda运行时确实是Node.js 8.10（node-oracledb 3.1.2支持这个版本，无兼容性问题）
• 检查代码中require("oracledb")的拼写是否正确，有没有大小写错误

按照上面的步骤调整后，应该就能解决找不到模块的问题了。

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