Node.js Lambda本地调试与CDK部署配置冲突问题求助

当你在根目录的package.json中添加"type": "module"时，Node.js会默认将所有JS/TS文件当作ES模块处理。但AWS CDK的TypeScript入口文件（比如你的Launcher.ts）在执行cdk synth时，底层是通过Node.js加载的——而ES模块模式下，Node.js不会自动识别.ts扩展名（它只认.mjs、.js等ES模块后缀），因此抛出文件扩展名未知的错误。

反过来，移除"type": "module"后，Node.js默认使用CommonJS模块系统，CDK可以正常加载TS文件，但你的Lambda本地调试依赖ES模块的语法（比如import/export），导致调试失败。本质是根目录单一的模块配置无法同时满足CDK（CommonJS优先）和Lambda本地调试（ES模块）的需求。

1. 拆分代码目录（推荐） #

把CDK基础设施代码和Lambda函数代码放到两个独立的子目录，各自拥有自己的package.json：

• 基础设施目录（比如infrastructure/）的package.json不添加"type": "module"，保持默认CommonJS模式，让CDK正常运行。
• Lambda函数目录（比如lambda/）的package.json添加"type": "module"，满足本地调试的ES模块需求。

项目结构示例：

your-project/
├── infrastructure/
│   ├── package.json
│   ├── tsconfig.json
│   └── Launcher.ts
└── lambda/
    ├── package.json
    └── index.js

这种方式彻底隔离了两个模块系统的冲突，是最干净的解决方案。

2. 自动化临时切换配置 #

如果不想拆分目录，可以写个脚本自动处理package.json的修改，避免手动切换：
在根目录的package.json中添加脚本：

"scripts": {
  "cdk-synth": "node -e \"const fs = require('fs'); const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8')); delete pkg.type; fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2))\" && cdk synth && node -e \"const fs = require('fs'); const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8')); pkg.type = 'module'; fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2))\""
}

执行npm run cdk-synth时，脚本会先移除"type": "module"，执行完cdk synth后再自动加回来，全程无需手动操作。

3. 给CDK入口文件指定ES模块后缀 #

把CDK的入口文件（Launcher.ts）重命名为Launcher.mts（ES模块的TypeScript后缀），这样即使根目录有"type": "module"，Node.js也能正确识别这个文件为ES模块，CDK也能正常加载它。

之后执行CDK命令时，直接指定这个后缀文件：

cdk synth --app "npx ts-node Launcher.mts"

或者在cdk.json的app字段里修改为：

{
  "app": "npx ts-node Launcher.mts"
}

4. 用不同的tsconfig区分模块 #

创建两个tsconfig文件，分别为CDK和Lambda配置模块系统：

• tsconfig-cdk.json（CDK用）：

{
  "compilerOptions": {
    "module": "CommonJS",
    "target": "ES2020",
    // 其他CDK需要的配置
  }
}

• tsconfig-lambda.json（Lambda用）：

{
  "compilerOptions": {
    "module": "ESNext",
    "target": "ES2020",
    // 其他Lambda需要的配置
  }
}

执行CDK命令时指定CDK的tsconfig：

cdk synth --app "npx ts-node -P tsconfig-cdk.json Launcher.ts"

Lambda本地调试则用ts-node -P tsconfig-lambda.json启动，这样两边的模块系统需求都能满足。

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