如何本地运行包含Node_modules的Node.js AWS Lambda Layers代码？

方法1：通过环境变量指定模块搜索路径 #

AWS Lambda运行时会自动将/opt/nodejs/node_modules（Node.js Layer的标准路径）加入Node.js模块搜索路径，但本地执行时需要手动配置：

• 终端临时设置环境变量：

  export NODE_PATH="/opt/nodejs/node_modules:$NODE_PATH"
  

• 执行你的本地运行命令：

  node --input-type=module -e "import {handler} from './index.js'; console.log(await handler(JSON.parse(fs.readFileSync('./event.json'))));"
  

• 注意：Layer本地目录结构要和AWS一致——Layer内容需放在/opt/nodejs下（而非直接/opt），即压缩包内应为nodejs/node_modules/[依赖包]，解压后对应/opt/nodejs/node_modules。

方法2：在代码中动态添加模块路径 #

若不想每次手动设置环境变量，可在Lambda入口文件开头添加代码，手动将Layer的依赖路径加入Node.js搜索路径：

import { fileURLToPath } from 'url';
import { dirname, join } from 'path';
import module from 'module';

const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);
// 添加Layer的node_modules路径到模块搜索列表
module.paths.push(join('/opt', 'nodejs', 'node_modules'));

本地运行时Node.js就能识别到Layer中的依赖模块。

方法3：使用AWS SAM/Serverless Framework模拟Lambda环境 #

这类框架会自动处理Lambda的运行环境配置（包括Layer路径），无需手动调整：

• AWS SAM：编写template.yaml定义Lambda和Layer后，执行：

  sam local invoke "YourLambdaFunctionName" -e event.json
  

• Serverless Framework：通过以下命令本地运行：

  serverless invoke local --function YourLambdaFunctionName --path event.json
  

关键注意事项 #

• 严格遵循Lambda Layer的目录规范：Node.js Layer的压缩包必须包含nodejs目录，内部存放node_modules和自定义代码，确保本地解压后对应/opt/nodejs路径。
• 若使用CommonJS模块（而非ES模块），路径添加代码可简化为：

  require('module').paths.push('/opt/nodejs/node_modules');
  

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