如何为Node.js Lambda本地开发Mock AWS DynamoDB等资源？

1. 环境变量动态切换（最轻量化方案） #

不用每次手动注释替换代码，通过环境变量判断环境，自动切换真实SDK和Mock实现。

步骤：

• 封装一个统一的DynamoDB操作工具类（比如dynamodb-client.js）：

import { DynamoDBClient, PutItemCommand } from "@aws-sdk/client-dynamodb";
import { data } from '../mockdb.js';

// 根据环境变量判断是否启用本地Mock
const isLocalDev = process.env.LOCAL_DEV === 'true';

export const insertToTable = async (item) => {
  if (isLocalDev) {
    // 本地Mock逻辑：模拟插入并返回结果
    console.log('Mock插入数据:', item);
    return { success: true, updatedData: [...data, item] };
  } else {
    // 线上真实AWS SDK逻辑
    const client = new DynamoDBClient({ region: 'your-region' });
    const command = new PutItemCommand({
      TableName: 'your-table-name',
      Item: item
    });
    return await client.send(command);
  }
};

• 本地运行时，通过环境变量触发Mock：LOCAL_DEV=true node your-lambda-code.js
• 业务代码直接调用insertToTable即可，无需任何修改，自动适配环境。

2. AWS SDK Mock库（无侵入式Mock） #

用专门的Mock库拦截AWS SDK请求，业务代码完全不用改动，适合不想封装工具类的场景。

以AWS SDK v3的aws-sdk-client-mock为例：

• 安装依赖：npm install aws-sdk-client-mock --save-dev
• 在本地启动入口文件中添加Mock配置（比如mock-aws-setup.js）：

import { mockClient } from "aws-sdk-client-mock";
import { DynamoDBClient, PutItemCommand } from "@aws-sdk/client-dynamodb";

// Mock DynamoDB客户端
const ddbMock = mockClient(DynamoDBClient);

// 针对PutItemCommand设置Mock响应
ddbMock.on(PutItemCommand).callsFake((input) => {
  console.log('Mock执行PutItem操作:', input.Item);
  // 返回和真实SDK一致格式的响应
  return { $metadata: { httpStatusCode: 200 } };
});

• 本地运行时先加载Mock配置：node -r ./mock-aws-setup.js your-lambda-code.js
• 业务代码正常使用AWS SDK即可，Mock会自动拦截所有请求并返回模拟结果。

3. 本地模拟AWS服务（最接近真实环境） #

用LocalStack或DynamoDB Local在本地启动一个完整的模拟AWS服务，API和真实环境完全兼容，无需修改业务代码。

以DynamoDB Local为例：

• 用Docker快速启动：docker run -p 8000:8000 amazon/dynamodb-local
• 在代码中根据环境变量切换SDK端点：

import { DynamoDBClient } from "@aws-sdk/client-dynamodb";

const client = new DynamoDBClient({
  region: 'your-region',
  // 本地开发时指向本地模拟服务
  endpoint: process.env.LOCAL_DEV === 'true' ? 'http://localhost:8000' : undefined
});

• 本地运行时设置LOCAL_DEV=true，SDK会自动连接本地的DynamoDB Local，操作逻辑和线上完全一致，还能用AWS CLI管理本地表：

aws dynamodb create-table --table-name your-table-name --attribute-definitions AttributeName=id,AttributeType=S --key-schema AttributeName=id,KeyType=HASH --provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 --endpoint-url http://localhost:8000

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