AWS Lambda本地调试过慢：求基于SAM CLI的TypeScript项目优化方案

• 服务：AWS Lambda
• CLI工具：SAM CLI
• 开发语言：TypeScript

1. 开启热重载容器 #

SAM CLI的--warm-containers参数可让Lambda容器保持运行状态，避免每次代码变更都重新初始化容器。执行以下命令启动本地API服务：

sam local start-api --warm-containers LAZY

• LAZY模式：首次请求时初始化容器，之后持续运行，仅在代码变更时重新加载函数代码
• EAGER模式：启动时就预热所有函数容器，适合需要快速响应首次请求的场景

2. 分离TypeScript自动编译与SAM服务 #

默认sam build包含TypeScript编译和依赖安装步骤，重复执行耗时较长。可拆分流程：

1. 单独启动TypeScript监听编译，代码变更时自动生成JavaScript文件：

tsc --watch

2. 启动SAM本地服务时跳过构建步骤，直接使用已编译的代码：

sam local start-api --warm-containers LAZY --skip-build

3. 用esbuild替代默认构建工具 #

在template.yaml中配置使用esbuild作为构建工具，它的编译速度远快于传统npm脚本，还支持增量构建：

Resources:
  YourLambdaFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: src/
      Handler: dist/app.lambdaHandler
      Runtime: nodejs20.x
    Metadata:
      BuildMethod: esbuild
      BuildProperties:
        Minify: false
        Sourcemap: true
        Target: "node20"
        EntryPoints:
          - app.ts
        OutDir: dist

配置后执行sam build会自动调用esbuild完成TypeScript编译，后续配合热重载和--skip-build参数，能大幅减少等待时间。

4. 单独调试单个Lambda函数 #

如果无需测试API网关路由，仅调试特定Lambda函数，直接使用sam local invoke配合热重载：

sam local invoke YourLambdaFunction --warm-containers LAZY --skip-build

每次代码变更后重新执行该命令即可，无需重启整个API服务，进一步提升调试效率。

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