AWS Lambda 如何获取event.body内的属性？访问时始终返回undefined

第一步：先验证event的真实结构，不要凭经验猜 #

• 不要依赖控制台折叠显示的对象结构判断层级，在Lambda函数最开头加入日志，将完整event序列化后输出：
  console.log('完整event结构：', JSON.stringify(event, null, 2))
• 查看CloudWatch中的日志输出，明确两个核心信息：
  • event中是否存在body字段
  • body字段的实际类型、嵌套层级结构

高频踩坑点及对应解决方案 #

1. event.body本身是JSON字符串，不是已解析的对象
   这是绝大多数场景下取不到值的核心原因：通过API Gateway（代理集成模式）、Lambda函数URL触发的Lambda，event.body是被序列化的字符串，并非原生JS对象。
   直接读取event.body.data本质是在字符串上访问属性，结果必然是undefined。
   注意：如果执行JSON.parse(event.body)后没有将解析结果赋值给变量，后续仍然从event.body上读取属性，等于解析操作完全没有生效。
   带异常兜底的正确解析逻辑如下：

let bodyContent = event?.body;
// 仅当body为字符串类型时执行解析
if (typeof bodyContent === 'string') {
  try {
    bodyContent = JSON.parse(bodyContent);
  } catch (err) {
    console.log('body解析失败，原始内容：', event.body);
    // 此处可直接返回请求参数错误的响应
  }
}
// 解析完成后再从解析结果上读取目标字段
const targetField = bodyContent?.data;

2. event中不存在body字段
   如果日志显示event里没有body层级，说明当前Lambda的触发源不是API Gateway或函数URL，比如是S3事件、DynamoDB流、SNS、SQS、EventBridge等触发源，这类场景的event结构完全自定义，不存在统一的body路径，需要对照日志里的实际字段层级取值。
   例如SQS触发的Lambda，消息内容位于event.Records[0].body，且该位置的内容同样是需要二次解析的JSON字符串。
3. API Gateway未开启代理集成模式
   如果是API Gateway触发但未启用Lambda代理集成，API Gateway会将请求体的字段直接展开到event的顶层，不会单独设置body包裹层，此时读取data字段应直接访问event.data，而非event.body.data。
4. 字段嵌套路径不匹配
   即便完成body解析，也要确认目标字段的实际位置：比如解析后的body结构为{ payload: { data: 'xxx' } }，直接读取body.data仍然会返回undefined。

其他易忽略的细节 #

• 链式取值时必须做层级兜底：比如直接写if(event.body.data)做判空时，如果event.body本身是undefined，会直接抛出类型错误，导致逻辑完全失效，推荐使用可选链操作符?.做层级判断。
• 如果请求体是二次序列化的内容（比如前端将JSON对象再次转为字符串作为body值），可能需要连续执行两次JSON.parse才能获取到内部属性。

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