NestJS+Serverless 本地/Docker调用Lambda时报无法确定事件源错误

报错根因 #

该报错核心是 NestJS对接Lambda的服务端适配器无法识别你传入的空事件格式：你用到的Lambda适配器（常见为@nestjs/platform-aws-lambda、@vendia/serverless-express）会自动根据Lambda事件的内置字段判断触发源（API Gateway v1/v2、ALB、EventBridge、SQS等），你传入的{}空对象没有任何触发源标识字段，直接触发校验失败。

排查步骤 #

• 先检查serverless.yml中对应函数的events配置，明确该Lambda的触发源类型，90%以上的Web场景都是API Gateway/HTTP API触发器
• 确认你本地安装的Lambda适配器依赖版本，部分旧版本存在事件格式校验的兼容性问题

解决方案 #

方案1：使用sls Offline自动映射的HTTP端点测试（推荐） #

sls offline启动时会自动把你配置的HTTP触发器映射为本地端口（默认3000）的HTTP接口，你不需要手动调用4000端口的Lambda原生调用接口，直接请求对应路径即可，适配器会自动完成事件格式转换。
比如你配置了如下触发器：

functions:
  main:
    handler: src/main.handler
    events:
      - httpApi: 'GET /'

直接调用curl http://localhost:3000/即可正常触发请求。

方案2：手动调用Lambda接口时传入符合规范的事件 #

如果你确实需要直接调用4000端口的Lambda原生调用接口，需要传入对应触发源的标准事件结构，比如API Gateway v2的最小可用事件示例：

{
  "version": "2.0",
  "rawPath": "/",
  "requestContext": {
    "http": {
      "method": "POST",
      "path": "/"
    }
  },
  "body": "{}",
  "isBase64Encoded": false
}

将你curl命令中的-d '{}'替换为上述完整结构即可。

方案3：非HTTP触发场景的适配 #

如果你的Lambda是EventBridge/SQS等非HTTP触发，需要传入对应服务的标准事件结构，比如EventBridge事件必须携带source、detail-type等标识字段，即可被适配器识别。

依赖兼容性问题修复 #

如果上述操作完成后仍然报错，将你的Lambda适配器依赖升级到最新稳定版即可：

# 如果你用的是官方aws-lambda适配器
npm install @nestjs/platform-aws-lambda@latest
# 如果你用的是serverless-express适配器
npm install @vendia/serverless-express@latest

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