如何在AWS控制台的Node.js Lambda中正确使用RxJS并解决依赖报错

问题根源 #

AWS Lambda控制台直接编写的代码仅包含Node.js内置模块，rxjs作为第三方npm包，默认不会被预装在运行环境中，因此会出现Cannot find package 'rxjs'的错误。

方法一：本地打包上传（单函数使用） #

1. 本地创建项目目录并初始化npm：

   mkdir lambda-rxjs && cd lambda-rxjs
   npm init -y
   

2. 安装rxjs依赖：

   npm install rxjs
   

3. 创建Lambda处理文件（如index.mjs），示例代码：

   import { Observable } from 'rxjs';
   
   export const handler = async (event) => {
     return new Promise((resolve) => {
       const obs$ = new Observable(subscriber => {
         subscriber.next('RxJS works in Lambda!');
         subscriber.complete();
       });
   
       obs$.subscribe({
         next: (msg) => resolve({
           statusCode: 200,
           body: JSON.stringify({ message: msg })
         })
       });
     });
   };
   

4. 将目录内所有文件（含node_modules、index.mjs等）打包为ZIP文件，确保文件位于ZIP根目录，不要嵌套子文件夹。
5. 进入AWS Lambda控制台，在目标函数的「代码」选项卡选择「上传从」→「.zip文件」，上传打包好的ZIP包。
6. 测试函数即可正常运行RxJS代码。

方法二：使用Lambda层（多函数复用） #

如果多个Lambda函数需要依赖rxjs，用层可以避免重复打包：

1. 本地创建层目录结构：

   mkdir rxjs-layer && cd rxjs-layer
   mkdir nodejs && cd nodejs
   npm init -y
   npm install rxjs
   

2. 返回rxjs-layer目录，将nodejs文件夹打包为ZIP文件（ZIP根目录必须是nodejs）。
3. 进入AWS Lambda控制台的「层」页面，点击「创建层」，填写层名称，上传ZIP包，选择与Lambda匹配的Node.js运行时版本，完成创建。
4. 回到目标Lambda函数，在「配置」→「层」中点击「添加层」，选择刚创建的rxjs层并保存。
5. 此时在控制台直接编写代码即可正常导入rxjs，代码示例同方法一。

注意事项 #

• 确保本地安装rxjs时的Node.js版本与Lambda运行时版本兼容（rxjs 7+支持Node.js 12及以上版本，Lambda主流的16.x/18.x版本均适用）。
• 若使用CommonJS格式（.js文件），导入语法改为const { Observable } = require('rxjs');，其余操作流程一致。

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