如何在不使用API Gateway的情况下本地调试Lambda函数？

当然可以不用API Gateway，直接本地运行和调试你的JS Lambda函数，下面是几种实用方案：

1. AWS SAM CLI 本地调用与调试 #

这是AWS官方推荐的本地开发工具，完全不需要API Gateway：

• 确保安装SAM CLI，将Lambda代码放到单独目录，创建template.yaml配置函数基础信息（比如Runtime设为nodejs18.x，指定Handler路径）
• 编写event.json文件，内容和AWS控制台测试用的事件格式保持一致
• 本地运行：执行sam local invoke <你的函数名> -e event.json，直接查看函数执行结果
• 断点调试：执行sam local invoke <你的函数名> -e event.json -d 5858，在VS Code中配置launch.json并附加到5858端口，即可在代码中设置断点调试

2. VS Code AWS Toolkit 直接调试Lambda #

你之前看到的API Gateway示例只是其中一种场景，Toolkit本身支持直接触发Lambda：

• 安装AWS Toolkit插件后，打开你的Lambda代码文件夹
• 在左侧AWS面板中，找到本地函数（或把本地代码关联到云端函数）
• 右键函数选择「Run Local」或「Debug Local」，输入JSON格式的测试事件（和控制台测试内容一致）
• 即可直接本地运行函数并断点调试，全程无需API Gateway参与

3. 纯Node.js环境模拟执行 #

如果不想用第三方工具，自己写个简单的执行脚本即可：

// local-runner.js
const { handler } = require('./path-to-your-handler-file');

// 模拟Lambda测试事件
const testEvent = {
  // 填入你的测试事件内容，比如 { "username": "test-user" }
};

// 简化版上下文（大部分场景足够使用）
const mockContext = {
  functionName: 'your-function-name',
  getRemainingTimeInMillis: () => 30000
};

// 执行handler
handler(testEvent, mockContext, (err, res) => {
  if (err) console.error('执行出错:', err);
  else console.log('执行结果:', res);
});

• 运行node local-runner.js就能直接执行函数，要调试的话，用VS Code的Node.js调试器直接运行该脚本即可

注意事项 #

• 本地运行时，AWS SDK会自动读取本地的AWS凭证（~/.aws/credentials），权限与云端调用一致
• 如果函数依赖Lambda Layer，SAM CLI可通过template.yaml配置本地Layer路径，或直接将Layer内容复制到函数目录
• 修改代码后直接重新运行/调试即可，无需部署到AWS

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