AWS CDK CodePipeline中如何安装NodejsFunction的package.json依赖？

我用CDK V2搭建CodePipeline，项目包含多个独立的NodejsFunction实例，每个Lambda函数目录下都有自己的package.json和依赖。本地执行cdk deploy --all可以正常部署，但CodeBuild阶段只安装根目录的依赖，导致部署时出现error TS2307: Cannot find module '@aws-sdk/client-sfn' or its corresponding type declarations这类依赖找不到的错误。

项目目录结构如下：

-Root
--src
---lambdaHandlers
----lambdaOne
-----index.ts
-----package.json
-----package-lock.json
----lambdaTwo
-----index.ts
-----package.json
-----package-lock.json

当前的CodePipeline CDK代码：

this.codePipeline = new CodePipeline(this, `${environment}-${appName}-`, {
  pipelineName: `${environment}-${appName}-`,
  selfMutation: true,
  crossAccountKeys: false,
  role: this.codePipelineRole,
  dockerEnabledForSynth: true,
  synth: new ShellStep("Deployment", {
    input: CodePipelineSource.codeCommit(this.codeRepository, environment, {  codeBuildCloneOutput: true }),
    installCommands: ["npm i -g npm@latest", "npm install -g typescript"],
    commands: [
      "npm ci",
      "npm run build",
      "cdk synth",
    ],
  })
});

我尝试在ShellStep的commands里手动添加进入每个Lambda目录执行npm ci的命令，虽然能安装依赖，但触发了TypeScript编译错误：intoMagentoQueueConsumer/node_modules/axios/index.d.ts(6,18): error TS1005: ']' expected.

解决方案 #

方案1：利用CDK NodejsFunction的自动依赖安装（推荐）

CDK的NodejsFunction本身支持自动安装Lambda目录下的依赖，不需要手动在CodeBuild里处理。确保你的NodejsFunction配置正确指定了入口文件和项目根路径（如果需要）：

new NodejsFunction(this, 'LambdaOne', {
  entry: './src/lambdaHandlers/lambdaOne/index.ts',
  // 若Lambda目录为独立项目根，指定该参数
  projectRoot: './src/lambdaHandlers/lambdaOne',
  runtime: Runtime.NODEJS_20_X,
});

CDK会在synth阶段自动为每个Lambda函数执行依赖安装命令，打包时自动包含所需依赖。这种方式无需修改CodeBuild命令，避免手动维护路径的麻烦。

方案2：批量遍历Lambda目录安装依赖，规避TS版本冲突

如果必须手动在CodeBuild中处理依赖，问题根源是不同目录的TS版本或类型定义冲突。可以用批量命令遍历所有Lambda目录，同时用子shell执行安装命令避免路径干扰：
修改ShellStep的commands：

# 安装根目录依赖
npm ci
# 遍历lambdaHandlers下所有子目录，存在package.json则执行npm ci
for dir in src/lambdaHandlers/*/; do
  if [ -f "$dir/package.json" ]; then
    echo "Installing dependencies for $dir"
    # 用子shell执行，避免切换目录影响后续命令
    (cd "$dir" && npm ci)
  fi
done
npm run build
cdk synth

同时要确保根目录和所有Lambda目录的TypeScript版本一致，消除类型定义冲突。

方案3：统一根目录管理依赖（适合依赖重叠度高的场景）

如果多个Lambda函数的依赖大部分重叠，可以把所有Lambda需要的依赖统一放在根目录的package.json中，CodeBuild安装根目录依赖后，Lambda编译时即可找到对应模块。这种方式需要调整Lambda代码的导入路径，或配置TS的paths字段映射模块位置。

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