Lambda函数无法从event获取HTTP方法：AWS控制台测试报错

问题场景 #

使用AWS Lambda函数时，尝试通过event.requestContext.http.method获取HTTP请求方法：

• VS Code的Thunder Client测试可正常返回结果，CloudWatch日志也能正确记录HTTP方法
• AWS控制台测试时抛出「Cannot read properties of undefined (reading 'http')」的TypeError错误

事件对象示例（Thunder Client触发时的日志） #

{
    "version": "2.0",
    "routeKey": "$default",
    "rawPath": "/",
    "rawQueryString": "",
    "headers": {
        "x-amzn-tls-cipher-suite": "ECDHE-RSA-AES128-GCM-SHA256",
        "x-amzn-tls-version": "TLSv1.2",
        "x-amzn-trace-id": "Root=1-64b50889-766dec4c58bf5b332f424218",
        "x-forwarded-proto": "https",
        "host": "i3xxbbcdnd6xunba6euxom7n6m0lohjs.lambda-url.ap-south-1.on.aws",
        "x-forwarded-port": "443",
        "x-forwarded-for": "49.36.81.218",
        "accept-encoding": "gzip, deflate, br",
        "accept": "*/*",
        "user-agent": "Thunder Client (https://www.thunderclient.com)"
    },
    "requestContext": {
        "accountId": "anonymous",
        "apiId": "i3xxbbcdnd6xunba6euxom7n6m0lohjs",
        "domainName": "i3xxbbcdnd6xunba6euxom7n6m0lohjs.lambda-url.ap-south-1.on.aws",
        "domainPrefix": "i3xxbbcdnd6xunba6euxom7n6m0lohjs",
        "http": {
            "method": "GET",
            "path": "/",
            "protocol": "HTTP/1.1",
            "sourceIp": "49.36.81.218",
            "userAgent": "Thunder Client (https://www.thunderclient.com)"
        },
        "requestId": "417bd641-b182-4b6f-b4c3-6fc39a81f594",
        "routeKey": "$default",
        "stage": "$default",
        "time": "17/Jul/2023:09:23:21 +0000",
        "timeEpoch": 1689585801077
    },
    "isBase64Encoded": false
}

尝试获取HTTP方法的代码 #

const method = await event.requestContext.http.method;

实际Lambda代码 #

module.exports.handler = async (event) => {
  console.log(JSON.stringify(event));
  const method = JSON.stringify(event.requestContext.http.method);
  console.log(method);
  return {
    statusCode: 200,
    body: method,
  };
}

完整报错信息（AWS控制台测试时） #

2023-07-17T09:33:22.176Z    c51956ea-a811-475d-b7ed-8c83b17bc2bf    ERROR   Invoke Error    {
    "errorType": "TypeError",
    "errorMessage": "Cannot read properties of undefined (reading 'http')",
    "stack": [
        "TypeError: Cannot read properties of undefined (reading 'http')",
        "    at module.exports.handler (/var/task/index.js:6:54)",
        "    at Runtime.handleOnceNonStreaming (file:///var/runtime/index.mjs:1086:29)"
    ]
}

原因分析 #

AWS控制台测试Lambda时，默认生成的测试事件是通用Lambda事件格式，而非Lambda URL触发的HTTP事件格式——前者没有requestContext.http层级结构，直接访问会导致requestContext或http未定义，抛出TypeError。而Thunder Client是通过Lambda URL触发请求，传递的是符合API Gateway/Lambda URL规范的HTTP事件结构，包含完整的requestContext.http字段。

解决方案 #

方案1：自定义控制台测试事件 #

在AWS控制台测试时，使用Thunder Client触发时的事件结构（即上述「事件对象示例」）作为测试输入，替换默认的测试事件。

方案2：代码兼容处理 #

在Lambda代码中增加空值判断，避免因事件格式不一致导致报错，示例代码如下：

module.exports.handler = async (event) => {
  console.log(JSON.stringify(event));
  // 兼容Lambda URL和传统API Gateway/控制台测试的事件格式
  const method = event.requestContext?.http?.method || event.httpMethod || 'UNKNOWN';
  console.log(method);
  return {
    statusCode: 200,
    body: JSON.stringify(method),
  };
}

说明：event.httpMethod是传统API Gateway触发Lambda时的请求方法字段，?.是可选链操作符，可避免访问未定义属性时抛出错误。

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