将Node.js应用拆分为多AWS Lambda函数：本地运行与架构工具问询

一、本地运行多Lambda架构的方式 #

1. AWS SAM CLI #

这是AWS官方工具，专门用来模拟Lambda和API Gateway的本地运行环境：

• 先编写template.yaml，为每个Endpoint单独声明对应的Lambda函数和API Gateway路由绑定
• 执行sam local start-api启动本地服务，所有请求会自动转发到对应的Lambda函数
• 举个template片段示例：

Resources:
  GetUserFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: ./src/get-user/
      Handler: index.handler
      Runtime: nodejs20.x
      Events:
        GetUser:
          Type: Api
          Properties:
            Path: /users/{id}
            Method: get

  CreateUserFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: ./src/create-user/
      Handler: index.handler
      Runtime: nodejs20.x
      Events:
        CreateUser:
          Type: Api
          Properties:
            Path: /users
            Method: post

• 本地修改Lambda代码后无需重启服务，SAM会自动加载更新后的代码

2. Serverless Framework #

这个工具生态更丰富，适配复杂场景：

• 在serverless.yml里配置每个Endpoint与Lambda的绑定关系
• 执行serverless offline启动本地模拟环境，还支持插件扩展（比如本地模拟DynamoDB这类依赖服务）

二、从现有Node.js应用提取Endpoint生成Lambda的方法 #

1. 针对Express应用的自定义脚本拆分 #

如果你的应用基于Express，可以写个简单脚本遍历路由，自动生成每个路由对应的Lambda文件和配置：

• 核心思路是遍历app._router.stack拿到所有路由的路径、请求方法和处理函数，将处理函数复制到单独的Lambda文件中，同时添加API Gateway事件与Express请求/响应的转换逻辑
• 极简脚本示例：

const fs = require('fs');
const path = require('path');
const app = require('./app'); // 引入你的Express实例

// 遍历所有路由
app._router.stack.forEach(layer => {
  if (layer.route) {
    const route = layer.route;
    const routePath = route.path;
    const method = Object.keys(route.methods)[0];
    const handlerName = route.stack[0].name;

    // 创建Lambda存放目录
    const lambdaDir = path.join(__dirname, 'src', `${method}-${routePath.replace(/\/|:|-/g, '_')}`);
    if (!fs.existsSync(lambdaDir)) fs.mkdirSync(lambdaDir, { recursive: true });

    // 生成Lambda处理代码
    const handlerCode = `
// 导入原路由的处理逻辑
const { ${handlerName} } = require('../../routes${routePath}');

exports.handler = async (event) => {
  // 把API Gateway事件转成Express风格的请求对象
  const req = {
    method: '${method.toUpperCase()}',
    params: event.pathParameters || {},
    query: event.queryStringParameters || {},
    body: event.body ? JSON.parse(event.body) : {}
  };

  // 模拟Express响应对象
  const res = {
    statusCode: 200,
    body: {}
  };

  // 执行原路由逻辑
  await ${handlerName}(req, res);

  // 把响应转成Lambda要求的格式
  return {
    statusCode: res.statusCode,
    body: JSON.stringify(res.body),
    headers: { 'Content-Type': 'application/json' }
  };
};
`;
    fs.writeFileSync(path.join(lambdaDir, 'index.js'), handlerCode);
  }
});

• 运行脚本前，记得把原应用的路由处理函数抽成单独模块，方便Lambda导入

2. 框架原生支持拆分 #

如果用的是NestJS或Fastify这类框架，本身就有工具支持拆分路由到独立Lambda：

• NestJS：使用@nestjs/aws-lambda模块，控制器里的每个方法都可以单独部署为Lambda，本地运行时结合SAM或Serverless Offline即可
• Fastify：借助fastify-lambda插件，可将不同路由绑定到不同Lambda，本地用fastify start配合Lambda模拟环境运行

3. 借助Lambda Web Adapter过渡 #

如果不想大幅修改现有代码，可以先用AWS Lambda Web Adapter把整个Express/Fastify应用包装成Lambda，再逐步拆分路由到单独的Lambda——先保留原有架构，再慢慢迁移，降低改造风险

三、拆分后的注意事项 #

• 共享逻辑（比如数据库连接、认证中间件）要抽成Lambda层（Layer）或独立npm包，避免在每个Lambda里重复编写
• 本地运行时要配置好Lambda的环境变量，SAM和Serverless Offline都支持在配置文件中添加environment字段
• 测试时直接用Postman或curl请求本地服务地址（比如http://localhost:3000/users/1），请求会自动转发到对应Lambda

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