Node.js 16 Lambda无法识别index模块问题求助

核心问题分析 #

你遇到的Runtime.ImportModuleError本质是Lambda无法直接运行TypeScript文件，且编译配置、处理程序路径、package.json设置存在不匹配，导致运行时找不到可执行的ES模块入口。

具体修复步骤 #

1. 修正TypeScript配置（tsconfig.json） #

确保TS编译输出符合ES模块规范，且指定输出目录：

{
  "compilerOptions": {
    "target": "ES2020", // 匹配Node.js 16支持的ES版本
    "module": "ESNext",
    "moduleResolution": "NodeNext", // 支持ES模块的解析逻辑
    "outDir": "./dist", // 编译后的JS文件输出到dist目录
    "rootDir": "./",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "resolveJsonModule": true
  },
  "include": ["index.mts"], // 包含你的TS入口文件
  "exclude": ["node_modules", ".aws-sam"]
}

2. 更新package.json配置 #

• 修正main字段指向编译后的ES模块入口
• 添加编译脚本

{
  "name": "responsive-score-lambda",
  "version": "1.0.0",
  "description": "",
  "main": "dist/index.mjs", // 指向编译后的mjs文件
  "type": "module", // 保留ES模块标识
  "scripts": {
    "build": "tsc", // 添加TS编译命令
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "@types/aws-lambda": "^8.10.114",
    "typescript": "^5.0.3"
  },
  "dependencies": {
    "aws-lambda": "^1.0.7"
  }
}

注：移除了ts-node和typeorm（如果不需要的话），ts-node仅用于本地TS运行，Lambda不需要。

3. 调整Lambda处理程序路径 #

Lambda的处理程序必须指向编译后的JS文件，而非TS源码：

• 如果直接在AWS控制台配置，设置为dist/index.handler
• 如果使用SAM（template.yml），修改Function的Handler字段：

Resources:
  YourLambdaFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: .
      Handler: dist/index.handler
      Runtime: nodejs16.x

4. 正确编译并部署 #

1. 本地执行编译命令：

npm run build

此时会在dist目录生成index.mjs文件。
2. 使用SAM部署时，执行：

sam build
sam deploy --guided

SAM会自动处理依赖安装和打包编译后的文件。

关键注意事项 #

• Lambda运行时无法直接解析TypeScript文件，必须提前编译为ES模块格式的.mjs文件
• package.json中的type:module必须保留，确保Lambda以ES模块方式加载你的代码
• 部署时不要将node_modules手动打包，SAM或Lambda层会自动处理依赖安装

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