基于CDK与SAM实现Serverless Lambda本地开发快速迭代方案咨询

核心思路 #

解决问题的关键是让SAM直接加载本地未打包的Lambda代码，而非依赖CDK synth生成的模板中内嵌的打包代码。这样代码变更时无需重复执行cdk synth，仅需处理代码编译（比如TypeScript转译），SAM就能通过热重载感知变更。

具体实现方案 #

1. 配置CDK输出本地代码路径到CloudFormation模板 #

修改CDK中Lambda函数的代码配置，让Code.fromAsset指向本地代码目录，并禁用开发环境下的代码压缩/打包，确保synth后的模板中CodeUri为本地路径而非打包后的Zip文件。

示例TypeScript代码：

import * as lambda from 'aws-cdk-lib/aws-lambda';
import { Stack, StackProps } from 'aws-cdk-lib';
import { Construct } from 'constructs';

export class LambdaStack extends Stack {
  constructor(scope: Construct, id: string, props?: StackProps) {
    super(scope, id, props);

    new lambda.Function(this, 'MyTsLambda', {
      runtime: lambda.Runtime.NODEJS_20_X,
      handler: 'dist/index.handler', // 指向TS编译后的JS文件
      code: lambda.Code.fromAsset('./src/lambda', {
        // 开发环境禁用打包压缩，直接复制文件到输出目录
        bundling: {
          minify: false,
          sourceMap: true,
          command: [
            'bash', '-c',
            'npm install --production=false && cp -r . /asset-output'
          ],
        },
        exclude: ['node_modules'], // 可选，避免复制过大的依赖目录，让SAM容器内安装
      }),
    });
  }
}

执行cdk synth --yaml > cdk.out/LambdaStack.template.yaml后，模板中Lambda的CodeUri会是类似./src/lambda的本地路径，SAM启动时会直接挂载该目录到容器中。

2. 启动TS实时编译 #

开启一个终端窗口，运行TypeScript实时编译命令，确保代码变更后立即生成JS文件：

tsc --watch --project ./src/lambda/tsconfig.json

3. 启动SAM本地服务并启用热重载 #

在另一个终端窗口运行SAM命令，开启API服务并启用热容器模式，确保容器能实时加载变更后的代码：

sam local start-api --template cdk.out/LambdaStack.template.yaml --warm-containers EAGER --docker-volume-basedir ./

• --warm-containers EAGER：保持容器活跃，代码变更后无需重启容器
• --docker-volume-basedir ./：确保本地代码目录正确挂载到SAM的Docker容器中

4. 仅在基础设施变更时执行CDK Synth #

后续开发中，**只有修改CDK基础设施代码（比如Lambda配置、新增资源）**时，才需要重新执行cdk synth更新模板；如果只是修改Lambda业务代码，仅需等待TS编译完成，SAM会自动重载新代码，无需任何额外操作。

额外优化技巧 #

• 使用nodemon监听TS代码变更，自动触发编译（可选）：

  nodemon --watch ./src/lambda --ext ts --exec "tsc --project ./src/lambda/tsconfig.json"
  

• 针对Node.js Lambda，在容器内安装依赖：如果本地node_modules过大，可在CDK配置中排除node_modules，让SAM启动容器时自动执行npm install，减少本地挂载的文件体积。

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